---
title: "A Stripe Checkout link for the subscription; a person opens and pays it"
method: POST
path: "/api/v1/billing/checkout"
---

# A Stripe Checkout link for the subscription; a person opens and pays it

`POST /api/v1/billing/checkout`

## Request

- Base URL: `https://uidwatch.tollwyn.com`
- URL: `https://uidwatch.tollwyn.com/api/v1/billing/checkout`
- Auth: HTTP bearer

## Request body

- object
  - `blocks` integer: Packages to start with; adjustable in Checkout

## Response `200`

The Checkout URL.

- object
  - `url` string, required

## Other responses

- `400`: The body is not JSON (invalid_json).
- `401`: No valid API key (unauthorized).
- `409`: The account has a subscription; use the portal (already_subscribed).
- `422`: blocks is not valid (invalid_request).
- `429`: Too many requests (rate_limited); see the Retry-After header.
- `503`: Billing is not configured or not set up (billing_unavailable).

---

[API](https://skmtc.dev/tollwyn/apis/uidwatch-api.md) · [All operations](https://skmtc.dev/tollwyn/apis/uidwatch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tollwyn/apis/uidwatch-api/revisions/198aa0efb0f6?raw)
