CDP REST APIAPI Reference
Get Subscription
Fetch one provider-scoped subscription contract by external id.
GET /cdp/commerce/subscriptions/{id} fetches one normalized subscription
contract by external id or local id. Unknown ids and ids belonging to another
brand both return the same 404.
Requires the beta:cdp-commerce permission on your brand.
Response 200
The response body is the same normalized subscription object used in List Subscriptions.
{
"id": "sub-local-1",
"external_id": "sub-skio-1",
"provider": "skio",
"status": "active",
"next_billing_date": "2026-08-01T00:00:00.000Z",
"billing_interval": "month",
"billing_interval_count": 1,
"total_price": "49.00",
"currency_code": "USD",
"customer": { "contact_id": "c9f0…", "external_customer_id": "123" },
"product_refs": [],
"created_at": "2026-06-01T00:00:00.000Z"
}Errors
| Status | When |
|---|---|
400 | Missing subscription id. |
401 | Missing or invalid credential. |
403 | Brand not enrolled in the commerce beta (beta_not_enabled), or no connected Shopify integration (integration_not_connected). |
404 | Subscription not found, including ids owned by another brand. |
405 | Non-GET method. |