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` or `cancelled`. Note: `cancelling` is a transient state and is not a valid filter value. | no |
| paused | string | Filter by paused state: `true` or `false`. | no |
| chain | string | CAIP-2 chain identifier (e.g. `eip155:1`). Filters subscriptions running on this chain. | no |
Example Request
const response = await fetch(
'https://checkout-api.exodus-int.com/subscriptions?limit=20&status=active&chain=eip155:1',
{
headers: {
Authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxx',
},
},
);Response
SUCCESSFUL RESPONSE
{
"object": "list",
"data": [
{
"object": "subscription",
"id": "0x9f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a",
"subscriber": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE21",
"token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"cap_amount": "120000000",
"period_duration": 2592000,
"last_charged_at": "2026-04-19T12:02:18Z",
"next_charge_at": "2026-05-19T12:02:18Z",
"charge_nonce": 3,
"status": "active",
"paused": false,
"created_at": "2026-02-19T12:02:18Z"
},
{
"object": "subscription",
"id": "0x4d2c1b0a9e8f7d6c5b4a39281706f5e4d3c2b1a0f9e8d7c6b5a493827160f5e4",
"subscriber": "0x8Ba1f109551bD432803012645Ac136ddd64DBA72",
"token": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
"cap_amount": "30000000",
"period_duration": 2592000,
"last_charged_at": "2026-05-01T12:00:00Z",
"next_charge_at": "2026-06-01T12:00:00Z",
"charge_nonce": 5,
"status": "cancelling",
"paused": true,
"created_at": "2026-01-01T00:00:00Z"
}
],
"has_more": true
}Pagination
const nextPage = await fetch(
'https://checkout-api.exodus-int.com/subscriptions?limit=20&starting_after=0x4d2c1b0a9e8f7d6c5b4a39281706f5e4d3c2b1a0f9e8d7c6b5a493827160f5e4',
{
headers: {
Authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxx',
},
},
);