Skip to main content
GET
Error

Authorizations

Authorization
string
header
required

A merchant secret key (sk_…) sent as Authorization: Bearer <key>.

Path Parameters

id
string
required

The subscription id (sub_…).

Response

The entitlement decision.

The access decision for a subscription.

entitled
boolean
required

True when the subscriber has active access. Use this field as the access gate; do not use access_until as the boundary.

reason
string
required

A human-readable explanation of the entitlement decision.

access_until
string | null
required

RFC 3339 timestamp of when access expires. Informational only — may be null or in the past while entitled is true (for example during dunning or when a renewal sweep is pending).