---
title: "Buy credits"
method: POST
path: "/v2/credits"
tags: ["billing"]
---

# Buy credits

`POST /v2/credits`

Creates a Stripe Checkout link the account owner opens in a browser to buy credits (quantity between 1000 and 10000). Creating a link never charges anything; payment happens only when a human completes checkout in the browser, and the purchased credits always land on this account.

## Request body

- object
  - `quantity` integer, required
  - `referral` string, nullable

## Response `201`

A Stripe Checkout link to buy credits.

- object — A Stripe Checkout link to buy credits.
  - `checkoutUrl` string, required — Stripe Checkout URL. The account owner opens this in a browser to complete payment. No charge occurs until checkout is completed.

## Other responses

- `400` — Default Response
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Rate limit exceeded
- `500` — Default Response

## Changes

- **2026-08-21** `39e94457ccb2` — 10 info
  - added the optional property `action` to the response with the `400` status
  - added the optional property `action` to the response with the `401` status
  - added the optional property `action` to the response with the `403` status
  - added the optional property `action` to the response with the `429` status
  - …6 more
- **2026-08-11** `51232970f10e` — 1 info
  - added the non-success response with the status `403`

[Change history](https://skmtc.dev/blotato/apis/blotato-api/changes/v2/credits/post.md)

---

[API](https://skmtc.dev/blotato/apis/blotato-api.md) · [All operations](https://skmtc.dev/blotato/apis/blotato-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blotato/blotato-api/revisions/c93447ba6b9d/schema)