Skip to main content
GET
/
v2
/
subscriptions

​
List Subscriptions

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

​
Authentication

Authorization: Bearer glm_test_YOUR_API_KEY

​
Query Parameters

ParameterTypeDescription
limitintegerNumber of results per page (default: 10, max: 100)
starting_afterstringCursor for pagination (subscription ID)
statusenumFilter by status: trialing, active, past_due, cancelled, ended
customer_idstringFilter by customer ID

​
Request

GET /v2/subscriptions?limit=10&status=active

​
Response

{
  "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

curl "https://api.withgale.com/v2/subscriptions?status=active" \
  -H "Authorization: Bearer glm_test_YOUR_API_KEY"