---
title: "Fetch Subscriptions"
method: GET
path: "/v1/subscriptions"
tags: ["Subscriptions"]
---

# Fetch Subscriptions

`GET /v1/subscriptions`

The following endpoint fetch existing subscriptions

## Query parameters

- `status` 'pending' | 'active' | 'past_due' | 'paused' | 'cancelled'
- `customer_id` string
- `from` string, date-time
- `to` string, date-time
- `page` integer
- `per_page` integer

## Headers

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

## Response `200`

Paginated list of subscriptions.

- object
  - `status` string
  - `data` object[]
    - `id` string
    - `status` 'pending' | 'active' | 'past_due' | 'paused' | 'cancelled'
    - `customer_id` string
    - `subscription_ref_id` string, nullable
    - `amount` integer — Amount in the smallest currency unit. 99000 = Rp 99,000.
    - `currency` string
    - `interval` 'daily' | 'weekly' | 'monthly' | 'annually' — Billing frequency unit.
    - `interval_count` integer
    - `next_billing_date` string, date-time, nullable
    - `created_at` string, date-time
  - `pagination` object
    - `page` integer
    - `per_page` integer
    - `total` integer — Total records matching the query, across all pages.

---

[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)