Get Subscription

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.