List subscriptions
Lists the customers' subscriptions to the store's memberships, newest first, with the plan, billing cycle, price, customer and current period. Filter by status, membership product, plan or date. Checkouts not paid yet are not included.
apiKeyAuthorizationBearer <token>A store API key from Settings → Developers → API keys, sent as Authorization: Bearer zk_live_….
limit?integerPage size, 1–100
1 <= value <= 10025cursor?stringnext_cursor from the previous page
length <= 500order?stringSort by created_at; newest first by default
"desc""desc""asc"created_after?stringOnly records created after this time
date-timecreated_before?stringOnly records created before this time
date-timeupdated_after?stringOnly records changed after this time — poll with your last sync time
date-timeupdated_before?stringOnly records changed before this time
date-timestatus?string"trialing""active""past_due""paused""canceled""expired"product_id?stringOnly subscriptions to this membership product
uuidplan_id?stringOnly subscriptions on this plan (product variant)
uuidSuccess
application/json- response
object*"list""list"data*array<>has_more*booleanWhether another page exists
next_cursor*stringPass as cursor to get the next page; null on the last
curl -X GET "https://example.com/subscriptions"{ "object": "list", "data": [ { "id": "00000000-0000-4000-8000-000000000501", "status": "active", "kind": "subscription", "product_id": "00000000-0000-4000-8000-000000000204", "product_name": "Pro Design Toolkit", "plan_id": "00000000-0000-4000-8000-000000000304", "plan_title": "Pro", "billing_cycle": { "unit": "month", "interval_count": 1 }, "price": "99.00", "currency": "SAR", "customer": { "id": "00000000-0000-4000-8000-000000000010", "name": "Sara Ahmed", "email": "[email protected]", "phone": "+966500000000" }, "answers": [ { "label": "Company name", "value": "Ahmed Studio" } ], "trial_ends_at": null, "current_period_start": "2026-10-01T10:00:00.000Z", "current_period_end": "2026-11-01T10:00:00.000Z", "next_billing_at": "2026-11-01T10:00:00.000Z", "cancel_at_period_end": false, "canceled_at": null, "canceled_by": null, "cancel_reason": null, "started_at": "2026-10-01T10:00:00.000Z", "ended_at": null, "latest_order_id": "00000000-0000-4000-8000-000000000002", "created_at": "2026-10-01T09:58:00.000Z", "updated_at": "2026-10-01T10:00:00.000Z", "object": "subscription" } ], "has_more": false, "next_cursor": null}