# Start a hosted billing checkout

> POST /billing/checkout

Source: https://docs.trykintsugi.com/reference/2026-10-06/start-a-hosted-billing-checkout

API version: Tenanted API release 2026-10-06, latest, default in the docs

POST /billing/checkout

Start a hosted billing checkout

Creates a one-time hosted checkout URL that subscribes the org to the given plan. Organization-Id, Connection-Id, or Entity-Id selects the org. `SCALE` and `PREMIUM` check out at the org's preset price. A `SCALE` checkout answers 400 while the Scale preset is closed. `GROWTH` checks out the legacy Starter plan at the standard metered price. `STARTER` checks out the current Starter plan. An org that cannot buy it yet gets the legacy Starter plan (`GROWTH`) instead, so its plan can read `GROWTH` after checkout. An org staged on the Scale preset checks out `GROWTH` or `STARTER` at its Scale price. If the org just started a checkout for the same plan and price, this returns that checkout again. Requires an owner or admin of the organization, or the organization's own API key.

Category: Billing

Request body:
billingPlan (PublicCheckoutPlanEnum, required) - One of `GROWTH` (the legacy Starter plan), `STARTER`, `SCALE` or `PREMIUM`: the plan tier to check out into. `STARTER` checks out the legacy Starter plan for an org that cannot buy the current one yet.
  allowed values: GROWTH, STARTER, SCALE, PREMIUM

Response fields:
id (string, required) - Billing hosted page id.
url (string, required) - One-time hosted checkout URL. Treat as a secret.
state (string, required) - Hosted page lifecycle state, e.g. `created`.
expiresAt (string, required) - When the checkout URL expires.

Response statuses: 201, 400, 401, 403, 404, 409, 422

---

Index of every page: https://docs.trykintsugi.com/llms.txt