v1

latestOpenAPI 3.1.02026-07-26500375.1 KB

Subscriptions

Fetch Subscriptions

The following endpoint fetch existing subscriptions

get/v1/subscriptions

Query parameters

status'pending' | 'active' | 'past_due' | 'paused' | 'cancelled'

Filter by subscription status.

customer_idstring

Filter by customer.

fromstring date-time

Include subscriptions with created_at >= from.

tostring date-time

Include subscriptions with created_at <= to.

pageinteger

Page number.

per_pageinteger

Items per page.

Headers

Content-Typestring required

Indicates the media type of the resource. value: application/json

X-Request-IDstring

Optional client-supplied idempotency and tracing ID, echoed back in the response.

Response

Paginated list of subscriptions.

statusstring

Example response

{
  "status": "success",
  "data": [
    {
      "id": "sub_xyz123",
      "customer_id": "cust_abc",
      "subscription_ref_id": "sub-ref-0001",
      "amount": 99000,
      "currency": "IDR",
      "interval_count": 1,
      "next_billing_date": "2026-04-14T10:00:00Z",
      "created_at": "2026-03-14T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 142
  }
}