List subscriptions

GET

/v1/subscriptions

curl "https://api.summerbase.com/v1/subscriptions" \
  -H "Authorization: Bearer sb_..."

The subscriptions of the project you are working in.

Parameters

Query Parameters

customer_id

string

Only this customer’s. Our id, or any source identity for them.

status

string

Allowed values: pending trialing active paused canceled

Only subscriptions in this state.

limit

integer

default: 20 >= 1 <= 100

How many records to return, 1 to 100. Defaults to 20.

cursor

string

The next_cursor of the previous page, to read the page after it.

include_total_count

boolean

Whether to add total_count, how many records match altogether. On the first page only: it is the same number on every page of one list, so keep the first page’s, and it is refused beside a cursor.

expand[]

Array<string>

<= 10 items

Allowed values: currency customer items owner_source

Relationships to include in the response instead of fetching separately. A dotted path expands what an expanded record can expand in turn — at most 4 deep, 10 paths a request, and never back to a record already on the path.

Response

Returns a list of subscription objects, a page at a time. See Pagination.

Media typeapplication/json

Example

{
  "data": [
    {
      "annual_amount": "15000.00",
      "billing_amounts": [
        {
          "interval": "month",
          "interval_count": 1,
          "net_amount": "1250.00"
        }
      ],
      "cancels_at": null,
      "currency_code": "USD",
      "current_period_ends_at": "2026-11-01T10:04:00Z",
      "customer_id": "0199a7c2-4e1b-7f38-b9d2-5a6c8e0f1d73",
      "ended_at": null,
      "id": "0199a7c2-5b3e-7a14-8c6d-2f9e4b7a1c05",
      "identities": [
        "stripe:sub_1QhT5uV7wX9yZ2aB"
      ],
      "monthly_amount": "1250.00",
      "object": "subscription",
      "owner_source_id": "0198f1a3-0b7c-7e25-9f41-6a2d8c3e5b19",
      "properties": {
        "account_manager": "Priya Shah"
      },
      "properties_by_source": {
        "backend": {
          "account_manager": "Priya Shah"
        },
        "stripe": {
          "contract_id": "C-2025-118"
        }
      },
      "recorded_at": "2025-11-17T10:04:03Z",
      "started_at": "2025-11-17T10:04:00Z",
      "status": "active",
      "trial_ends_at": "2025-12-01T10:04:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "object": "list",
  "total_count": 1
}