Tidepay API Docs
API ReferenceSubscriptions

List subscriptions

GET
/subscriptions

Filter by status, customerId, and/or planId; offset-paginated via limit/start (default 20, max 100 per page).

X-API-Key<token>

Your merchant API key, shown once at creation in the dashboard (Settings → API key).

In: header

Query Parameters

status?string

Value in

  • "pending"
  • "active"
  • "past_due"
  • "canceled"
customerId?string
planId?string
limit?integer

Max 100, default 20.

start?integer

Offset for pagination, default 0.

Response Body

curl -X GET "https://example.com/subscriptions"
Empty