Skip to main content
GET
/
api
/
v1
/
subscriptions
List Subscriptions
curl --request GET \
  --url https://api.example.com/api/v1/subscriptions
{
  "data": [
    {
      "id": "...",
      "customer_id": "...",
      "plan_id": "...",
      "plan_name": "Pro",
      "status": "ACTIVE",
      "billing_interval": "month",
      "current_period_start": "2025-01-01T00:00:00Z",
      "current_period_end": "2025-02-01T00:00:00Z",
      "created_at": "2025-01-01T00:00:00Z"
    }
  ],
  "meta": { "page": 1, "page_size": 20, "total": 15, "total_pages": 1 }
}
​
page
integer
default:"1"
Page number
​
page_size
integer
default:"20"
Items per page (max 100)
​
customer_id
string
Filter by customer UUID
​
status
string
Filter by status: TRIAL, ACTIVE, PAST_DUE, PAUSED, CANCELED
{
  "data": [
    {
      "id": "...",
      "customer_id": "...",
      "plan_id": "...",
      "plan_name": "Pro",
      "status": "ACTIVE",
      "billing_interval": "month",
      "current_period_start": "2025-01-01T00:00:00Z",
      "current_period_end": "2025-02-01T00:00:00Z",
      "created_at": "2025-01-01T00:00:00Z"
    }
  ],
  "meta": { "page": 1, "page_size": 20, "total": 15, "total_pages": 1 }
}