SnozeDevelopers
API referenceBilling

Recover the workspace's pending checkout

Requires billing:manage. Returns the existing verified recurring checkout without creating or changing a purchase, including legacy single-product sessions. Expired and failed sessions return null.

GET
/v1/workspaces/{workspaceId}/billing/checkout

Authorization

apiKey
headerAuthorizationBearer <snoze_sk_…>

Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.

Path Parameters

workspaceId*string

Response Body

Success

application/json
  1. response
data*|null
Example Request
curl -X GET 'https://api.snoze.dev/v1/workspaces/string/billing/checkout'
Example Response
{  "data": {    "id": "string",    "url": "string",    "status": "open",    "plan": "free",    "interval": "month",    "expiresAt": "string"  }}

Read the workspace usage breakdown

Returns per-resource usage counts for the workspace. Deliberately open to any workspace member rather than gated on `billing:read`, because these counts are what the interface uses to explain why a limit-bound action is unavailable.

Open a checkout session for a plan

Creates a Polar checkout session for the requested plan and interval, sized to the workspace's current seat count, and returns the URL for an embedded or hosted checkout. Optional embedOrigin and successUrl must use configured app origins. Requires a Clerk session with a synced profile and the `billing:manage` workspace permission; opening checkout also records a pricing-experiment exposure so a direct link is attributed like a catalog view.