Get a subscription

GET

/v1/subscriptions/:id

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

Fetch one subscription, by Summerbase id or by any source’s id for it.

Parameters

Path Parameters

id

required

string

Its Summerbase id, or an identity ref: a source slug and that source’s own id for it, joined by a colon — stripe:sub_123.

Example

0199a7c2-5b3e-7a14-8c6d-2f9e4b7a1c05

Query Parameters

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 the subscription object.

Media typeapplication/json

Example

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