v1

latestOpenAPI 3.1.0AGPL-3.0-only2026-07-1773264353.7 KB

Subscriptions

List subscriptions

List subscriptions with optional filtering by customer or plan.

get/api/v1/subscriptions

Query parameters

customer_idstring

Filter by customer ID or alias

plan_idstring MeteroidId

Example:plan_7n42DGM5Tflk9n8mt7Fhc7

statusesstring[]

order_bystring

Sort order. Format: column.direction. Allowed columns: customer_name, plan_name, mrr_cents, billing_start_date, end_date, status, created_at. Direction: asc or desc. Default: created_at.desc.

pageinteger

Page number (0-indexed)

per_pageinteger

Number of items per page

Response

List of subscriptions

Example response

{
  "data": [
    {
      "currency": "EUR",
      "customer_id": "cus_7n42DGM5Tflk9n8mt7Fhc7",
      "id": "sub_7n42DGM5Tflk9n8mt7Fhc7",
      "payment_methods_config": {
        "account_id": "ba_7n42DGM5Tflk9n8mt7Fhc7"
      },
      "plan_id": "plan_7n42DGM5Tflk9n8mt7Fhc7",
      "plan_version_id": "plv_7n42DGM5Tflk9n8mt7Fhc7"
    }
  ]
}