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

# List Subscriptions

> Retrieve a list of all subscriptions with optional filtering

# List Subscriptions

Returns a paginated list of subscriptions, ordered by creation date (most recent first).

## Authentication

```bash theme={null}
Authorization: Bearer glm_test_YOUR_API_KEY
```

## Query Parameters

| Parameter        | Type    | Description                                                              |
| ---------------- | ------- | ------------------------------------------------------------------------ |
| `limit`          | integer | Number of results per page (default: 10, max: 100)                       |
| `starting_after` | string  | Cursor for pagination (subscription ID)                                  |
| `status`         | enum    | Filter by status: `trialing`, `active`, `past_due`, `cancelled`, `ended` |
| `customer_id`    | string  | Filter by customer ID                                                    |

## Request

```bash theme={null}
GET /api/v2/subscriptions?limit=10&status=active
```

## Response

```json theme={null}
{
  "data": [
    {
      "id": "sub_abc123",
      "customer_id": "cus_xyz789",
      "status": "active",
      "amount_cents": 9900,
      "interval": "monthly",
      "next_billing_date": "2025-11-18T14:30:00Z",
      "created_at": "2025-10-18T14:30:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "sub_abc123"
}
```

## Examples

```bash theme={null}
curl "https://api.withgale.com/api/v2/subscriptions?status=active" \
  -H "Authorization: Bearer glm_test_YOUR_API_KEY"
```

## Related Endpoints

* [Get Subscription](/api-reference/endpoint/get-subscription)
* [Create Subscription](/api-reference/endpoint/create-subscription)