Skip to main content
GET
Returns the core subscription attached to the authenticated key owner (workspace owner for workspace keys, owner user for personal keys). Use this endpoint to show customers:
  • current tier and subscription status
  • credits limit, credits used, and credits remaining
  • next renewal period end (renews_at) and credits reset date

Response

string
Authenticated key scope: workspace or personal.
string | null
Workspace ID for workspace keys, otherwise null.
object
Active core subscription details.

Error Responses

  • 401 - authentication failed (missing/invalid/revoked token)
  • 402 subscription_required - active Creator/Professional/Business plan required
  • 403 tier_not_allowed - Scheduler tier cannot use Partner API
  • 500 subscription_lookup_failed - unexpected subscription lookup failure