Subscriptions
List subscriptions
Returns a keyset page of the community's subscriptions, newest first. Filter by status, plan, tier, or member.
Authorization
apiKey AuthorizationBearer <token>
Community-scoped API key. Send it as Authorization: Bearer arclt_live_.... Keys carry scopes; endpoints that need a specific scope answer 403 missing_scope when the key lacks it.
In: header
Query Parameters
cursor?string
Opaque keyset cursor copied verbatim from a previous response's next_cursor. Omit it to fetch the first page.
limit?integer
Page size, capped at 100.
Default
25Range
1 <= value <= 100status?string
Filter by lifecycle status (for example active or past_due).
plan_id?string
Filter by backing billing plan.
tier_id?string
Filter by plan tier.
member_id?string
Filter by owning member.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/subscriptions?cursor=eyJpZCI6IjAxSk1aWDQ3In0&limit=25"{
"data": [
{
"id": "sub_01JMZX47H8Q2C9R4T1",
"status": "active",
"plan_id": "plan_01JMZX3B2K",
"tier_id": "tier_01JMZX2A9F",
"member_id": "mem_01JMZX1Z7D",
"amount_cents": 1500,
"currency": "usd",
"interval": "month",
"current_period_end": "2026-08-01T00:00:00Z",
"cancel_at": "2026-08-01T00:00:00Z",
"paused_until": "2019-08-24T14:15:22Z",
"created_at": "2026-05-01T12:00:00Z",
"updated_at": "2026-07-01T12:00:00Z"
}
],
"next_cursor": "eyJpZCI6InN1Yl8wMUpNWlg0NyJ9"
}{
"type": "https://docs.arcalotl.com/api/errors#not_found",
"title": "Not Found",
"status": 404,
"detail": "The requested resource was not found.",
"code": "not_found"
}{
"type": "https://docs.arcalotl.com/api/errors#not_found",
"title": "Not Found",
"status": 404,
"detail": "The requested resource was not found.",
"code": "not_found"
}{
"type": "https://docs.arcalotl.com/api/errors#not_found",
"title": "Not Found",
"status": 404,
"detail": "The requested resource was not found.",
"code": "not_found"
}