Retrieve Subscription
Retrieves the details of a specific subscription by its ID.
Authorizations
Path Parameters
The unique identifier of the subscription.
Response
200
"7304911d-5df9-429e-8488-ad41abea1a4c"
"sub_001"
"streaming service"
"2404911d-5df9-429e-8488-ad41abea1a4b"
"001_marzo_23"
"ACME SUBSCRIPTION"
"ACTIVE"
Only returned by this endpoint, and only once the first billing cycle has been charged. Always returned together with current_period_end.
"2023-01-16T20:00:00.912480Z"
Only returned by this endpoint, and only once the first billing cycle has been charged. Equal to billing_cycles.next_at. Always returned together with current_period_start.
"2023-02-16T20:00:00.786342Z"
"sa_6af2dfcd-44c0-4f16-a331-8bed3ed9c9fa"
Only present when the subscription is linked to a plan.
"00000000-0000-4000-8000-000000000001"
Only present on plan-linked subscriptions. The moment the plan was attached — at creation from a plan, migration onto a plan, or a plan change.
"2023-12-16T20:46:54.786342Z"
Only present when this subscription was created by a plan change (switching an existing subscription to a different plan).
Only present on plan-linked subscriptions.
"REGULAR"
Only present on plan-linked subscriptions whose plan has phases. Contains the leading TRIAL phases only, snapshotted at creation — the terminal REGULAR phase is never included, since its price isn't pinned and instead resolves from the plan at every billing. current_phase: "REGULAR" is how you know the ladder is exhausted.
The plan change scheduled for the next billing cycle, or null when none is pending. Schedule one with the plan_change block on Update Subscription.
"2023-12-16T20:46:54.786342Z"
"2023-12-16T21:00:54.786342Z"