List Subscriptions
GET/subscriptionsDescription
Retrieve a list of subscriptions for your account. Results are returned in descending order by creation date, with the most recent first.
Headers
| Header | Description | Required |
|---|---|---|
| Authorization | Bearer token with your API key | yes |
Query Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| limit | number | Maximum number of subscriptions to return (default: 50, max: 100). | no |
| starting_after | string | Cursor for pagination. Returns subscriptions after this ID. | no |
| ending_before | string | Cursor for pagination. Returns subscriptions before this ID. | no |
| status | string | Filter by status: `active`, `cancelling`, or `cancelled`. | no |
| subscriber | string | Filter by on-chain subscriber EVM address. | no |
| external_customer_id | string | Filter by the merchant-supplied customer reference. | no |
| subscription_checkout_id | string | Filter by the originating SubscriptionCheckout ID. | no |
| chain | string | CAIP-2 chain identifier (e.g. `eip155:1`). Filters subscriptions running on this chain. | no |
| created_gte | string | Filter subscriptions created on or after this ISO 8601 timestamp. | no |
| created_lte | string | Filter subscriptions created on or before this ISO 8601 timestamp. | no |
Example Request
const response = await fetch(
'https://checkout.exodus.com/subscriptions?limit=20&status=active&chain=eip155:1',
{
headers: {
Authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxx',
},
},
);Response
SUCCESSFUL RESPONSE
{
"object": "list",
"data": [
{
"id": "sub_abc123def456",
"object": "subscription",
"status": "active",
"subscription_checkout_id": "schk_1234567890abcdef",
"onchain_id": "0x9f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a",
"subscriber": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE21",
"external_customer_id": "cus_42",
"chain": "eip155:1",
"subscription_manager_address": "0xA1B2C3D4E5F6789012345678901234567890ABCD",
"token_symbol": "USDC",
"token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"charge_amount": "9990000",
"cap_amount": "120000000",
"period_duration": 2592000,
"charge_nonce": 3,
"charge_amount_update_nonce": 0,
"cancel_at_period_end": false,
"last_charged_at": "2026-04-19T12:02:18Z",
"next_charge_at": "2026-05-19T12:02:18Z",
"metadata": { "external_plan_ref": "pro_monthly" },
"created_at": "2026-02-19T12:02:18Z",
"cancelled_at": null
},
{
"id": "sub_def456ghi789",
"object": "subscription",
"status": "cancelling",
"subscription_checkout_id": "schk_abcdef1234567890",
"onchain_id": "0x...",
"subscriber": "0x...",
"external_customer_id": "cus_43",
"chain": "eip155:137",
"subscription_manager_address": "0xB2C3D4E5F67890123456789012345678901234CD",
"token_symbol": "USDC",
"token_address": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
"charge_amount": "2999000",
"cap_amount": "30000000",
"period_duration": 2592000,
"charge_nonce": 5,
"charge_amount_update_nonce": 0,
"cancel_at_period_end": true,
"last_charged_at": "2026-05-01T12:00:00Z",
"next_charge_at": "2026-06-01T12:00:00Z",
"metadata": {},
"created_at": "2026-01-01T00:00:00Z",
"cancelled_at": null
}
],
"has_more": true
}Pagination
const nextPage = await fetch(
'https://checkout.exodus.com/subscriptions?limit=20&starting_after=sub_def456ghi789',
{
headers: {
Authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxx',
},
},
);