Sign in

v1

latestOpenAPI 3.1.02026-07-26500375.1 KB
Subscriptions

Fetch Subscription Charges

The following endpoint fetch all payments on a single subscription

get/v1/subscriptions/{id}/charges

Path parameters

idstring required

Durianpay's subscription identifier. ID that you received on Create Subscription API Response

Query parameters

status'processing' | 'success' | 'failed'

Filter by charge status.

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 charge history.

statusstring

Example response

{
  "status": "success",
  "data": [
    {
      "id": "chr_abc001",
      "subscription_id": "sub_xyz123",
      "order_id": "ord_001",
      "billing_cycle": 3,
      "charge_type": "automatic",
      "status": "success",
      "created_at": "2026-03-14T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 142
  }
}