Subscriptions/getSubscription

Get a subscription

Planned

Planned. This contract is published ahead of the build. It is not callable yet — treat it as the shape to design against, not a live endpoint.

Retrieve a subscription by ID.

GET/v1/subscriptions/{id}

Returns a subscription by ID, including its status, the price it bills, and the current billing period.

Path parameters

idstringRequired

Response

application/json

idstring

Example "sub_9c2a4f10"

customerIdstring

Example "cus_123"

priceIdstring

Example "price_pro_monthly"

statusenum

trialingactivepast_duecanceled

Example "active"

currentPeriodEndstring · ISO 8601

Example "2026-04-09T09:14:22Z"

cancelAtPeriodEndboolean

Example false

createdAtstring · ISO 8601

Example "2026-04-09T09:14:22Z"

getSubscription