Subscriptions
Get Subscription
Retrieve a specific subscription by its stable ID (sub_stable_) or internal ID (sub_). Returns full subscription details including associated customer, plan, and price. Use includeFeatures to also get feature entitlements.
Authorization
bearerAuth AuthorizationBearer <token>
Use your secret API key as the bearer token
In: header
Path Parameters
id*string
Subscription stable ID (sub_stable_) or internal ID (sub_)
Query Parameters
includeFeatures?string
Include feature entitlements with full feature details
Default
"false"Value in
"true" | "false"Response Body
application/json
application/json
application/json
curl -X GET "https://api.getlumen.dev/v1/subscriptions/sub_stable_abc123"{
"subscription": {
"id": "string",
"customerId": "string",
"planId": "string",
"priceId": "string",
"status": "active",
"currentPeriodStart": "2019-08-24T14:15:22Z",
"currentPeriodEnd": "2019-08-24T14:15:22Z",
"cancelAtPeriodEnd": true,
"stripeSubscriptionId": "string",
"createdAt": "2019-08-24T14:15:22Z"
}
}{
"error": "Subscription not found or access denied"
}{
"error": "string",
"details": "string"
}