---
title: "Fetch Subscription Charges"
method: GET
path: "/v1/subscriptions/{id}/charges"
tags: ["Subscriptions"]
---

# Fetch Subscription Charges

`GET /v1/subscriptions/{id}/charges`

The following endpoint fetch all payments on a single subscription

## Path parameters

- `id` string, required

## Query parameters

- `status` 'processing' | 'success' | 'failed'
- `page` integer
- `per_page` integer

## Headers

- `Content-Type` string, required
- `X-Request-ID` string

## Response `200`

Paginated charge history.

- object
  - `status` string
  - `data` object[]
    - `id` string
    - `subscription_id` string
    - `order_id` string
    - `billing_cycle` integer
    - `charge_type` 'automatic' | 'manual'
    - `status` 'processing' | 'success' | 'failed'
    - `created_at` string, date-time
  - `pagination` object
    - `page` integer
    - `per_page` integer
    - `total` integer — Total records matching the query, across all pages.

## Other responses

- `403` — The subscription belongs to a different merchant.
- `404` — No subscription with the given id exists.

---

[API](https://skmtc.net/durianpay/apis/durianpay-api.md) · [All operations](https://skmtc.net/durianpay/apis/durianpay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/durianpay/durianpay-api/revisions/ffc0e7e8a227/schema)