> ## Documentation Index
> Fetch the complete documentation index at: https://docs.khaime.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Subscriptions

> List all subscriptions with pagination and filtering.

# List Subscriptions

Retrieve all subscriptions for your merchant account with filtering and pagination.

## Query Parameters

<ParamField query="status" type="string">
  Filter by status: `pending`, `active`, `due`, `cancelled`, `paused`
</ParamField>

<ParamField query="product_id" type="integer">
  Filter by product ID.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Results per page (1-100).
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Pagination offset.
</ParamField>

<ParamField query="sort_by" type="string" default="created_at">
  Sort field: `created_at`, `next_payment`, `actual_price`, `payment_status`
</ParamField>

<ParamField query="sort_order" type="string" default="DESC">
  `ASC` or `DESC`
</ParamField>

## Response

```json theme={null}
{
  "success": true,
  "data": {
    "subscriptions": [
      {
        "id": "sub_abc123",
        "product_id": 3046,
        "customer_email": "jane@example.com",
        "amount": 4999,
        "currency": "USD",
        "frequency": "monthly",
        "status": "active",
        "next_payment_date": "2026-02-16T21:05:00.000Z",
        "created_at": "2026-01-16T21:05:00.000Z"
      }
    ],
    "total": 1,
    "limit": 20,
    "offset": 0
  }
}
```

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.khaime.com/api/v1/partner/subscriptions?status=active&limit=10" \
    -H "X-API-Key: pk_sandbox_your_key"
  ```
</RequestExample>