---
title: "POST /v1/checkout/subscription"
method: POST
path: "/v1/checkout/subscription"
tags: ["billing"]
---

# POST /v1/checkout/subscription

`POST /v1/checkout/subscription`

## Request

- Base URL: `https://api.mangii.ai`
- URL: `https://api.mangii.ai/v1/checkout/subscription`
- Auth: HTTP bearer

Requires billing:write scope or dashboard session.

## Headers

- `Idempotency-Key` string, required

## Response `200`

Stripe Checkout URL for a human

## Other responses

- `429`: Per-key rate limit exceeded for the current minute bucket. Every /v1 operation shares one per-key limiter, so any of them can return this.

---

[API](https://skmtc.dev/mangii/apis/mangii-headless-api.md) · [All operations](https://skmtc.dev/mangii/apis/mangii-headless-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mangii/apis/mangii-headless-api/revisions/40aba1e6eae0?raw)