List Subscription Checkouts
GET/subscription-checkoutsDescription
Retrieve a list of subscription checkout intents. Results are returned in descending order by creation date.
Headers
| Header | Description | Required |
|---|---|---|
| Authorization | Bearer token with your API key | yes |
Query Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| limit | number | Maximum number of intents to return (default: 50, max: 100). | no |
| starting_after | string | Cursor for pagination. Returns intents created after this intent ID. | no |
| ending_before | string | Cursor for pagination. Returns intents created before this intent ID. | no |
| status | string | Filter by status: `pending`, `completed`, `cancelled`, or `expired`. | no |
| subscriber | string | Filter by subscriber EVM address. | no |
| external_customer_id | string | Filter by the merchant-supplied customer reference. | no |
| chain | string | CAIP-2 chain identifier. Filters intents whose `supported_chains` includes this chain. | no |
| created_gte | string | ISO 8601 timestamp. Returns intents created on or after this time. | no |
| created_lte | string | ISO 8601 timestamp. Returns intents created on or before this time. | no |
Example Request
const response = await fetch(
'https://checkout.exodus.com/subscription-checkouts?limit=20&status=completed',
{
headers: {
Authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxx',
},
},
);Response
SUCCESSFUL RESPONSE
{
"object": "list",
"data": [
{
"id": "schk_1234567890abcdef",
"object": "subscription_checkout",
"status": "completed",
"onchain_id": "0x9f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a",
"subscriber": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE21",
"external_customer_id": "cus_42",
"supported_chains": ["eip155:1", "eip155:137"],
"token_symbol": "USDC",
"charge_amount": "9990000",
"period_duration": 2592000,
"cap_amount": "120000000",
"checkout_url": "https://checkout.exodus.com/subscribe/schk_1234567890abcdef",
"success_url": "https://merchant.com/subscribed",
"cancel_url": "https://merchant.com/cancelled",
"metadata": { "external_plan_ref": "pro_monthly" },
"subscription_id": "sub_abc123def456",
"expires_at": "2026-05-19T12:05:00Z",
"created_at": "2026-05-19T12:00:00Z",
"completed_at": "2026-05-19T12:02:18Z"
},
{
"id": "schk_abcdef1234567890",
"object": "subscription_checkout",
"status": "completed",
"onchain_id": "0x...",
"subscriber": "0x...",
"external_customer_id": "cus_43",
"supported_chains": ["eip155:1"],
"token_symbol": "USDC",
"charge_amount": "2999000",
"period_duration": 2592000,
"cap_amount": "30000000",
"checkout_url": "https://checkout.exodus.com/subscribe/schk_abcdef1234567890",
"metadata": {},
"subscription_id": "sub_def456ghi789",
"expires_at": "2026-05-18T12:05:00Z",
"created_at": "2026-05-18T12:00:00Z",
"completed_at": "2026-05-18T12:01:42Z"
}
],
"has_more": true
}Pagination
const nextPage = await fetch(
'https://checkout.exodus.com/subscription-checkouts?limit=20&starting_after=schk_abcdef1234567890',
{
headers: {
Authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxx',
},
},
);