---
title: "Buy a one-time credits top-up"
method: POST
path: "/subscriptions/credits/checkout"
tags: ["Subscriptions"]
---

# Buy a one-time credits top-up

`POST /subscriptions/credits/checkout`

## Request

- Base URL: `https://api.atako.ai`
- URL: `https://api.atako.ai/subscriptions/credits/checkout`
- Auth: HTTP bearer

Company-admin only.

## Request body

- object
  - `credits` integer, required
  - `locale` string

## Response `200`

- union
  - object
    - `url` string, uri, required
  - object
    - `url` unknown, required
    - `balance` CreditBalance, required
      - `id` string, uuid
      - `companyId` string, uuid
      - `includedBalance` integer, required
      - `purchasedBalance` integer, required
      - `currentPeriodStart` string, date-time, nullable
      - `currentPeriodEnd` string, date-time, nullable
      - `updatedAt` string, date-time
      - `consumedThisPeriod` integer, required: Ledger sum of consumption transactions since currentPeriodStart (or the start of the current UTC calendar month).

## Other responses

- `400`: credits must be an integer between 1000 and 50000
- `401`: Missing, malformed, or invalid bearer token / API key, or revoked session (SESSION_REVOKED).
- `403`: The caller does not have the required role/permission.
- `404`: No company / Company not found

---

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