Get a subscription
Fetches a single subscription by ID, including the current active version reference, any pending future versions, and open_change: the subscription change that is open, with its approval status, when one waits.
Authorizations
API key authentication. Pass your API key as a Bearer token.
Headers
2026-04-01 Path Parameters
Unique identifier for the subscription
Response
Success
Users assigned to the subscription, such as its owner
Billing configuration
Contract configuration
When the subscription was created
"2025-12-15T10:30:00Z"
ISO 4217 currency code
"USD"
Customer ID
"cust_abc123"
Unique identifier
"sub_abc123"
Key-value metadata
Subscription name
"Acme Corp - Enterprise"
Pending version changes
Renewal configuration
Subscription status
draft, active, canceled, approved, ended "active"
When the subscription was last updated
"2026-04-04T10:00:05Z"
When the subscription was activated
"2026-01-01T00:00:00Z"
Current active version ID
"subv_abc123"
Subscription-level discount
Maximum spend threshold
Minimum spend threshold
The open direct change of the subscription, when one waits. A dashboard user resolves a waiting, rejected or stale change
Plan ID
"pln_abc123"
Price escalation configuration
Trial period in days
30