---
title: "Top up USD credits"
method: POST
path: "/v1/billing/add-credits"
tags: ["Billing"]
---

# Top up USD credits

`POST /v1/billing/add-credits`

## Request

- Base URL: `https://api.auxen.ai`
- URL: `https://api.auxen.ai/v1/billing/add-credits`
- Auth: HTTP bearer

Returns a Stripe Checkout URL. Open it in a browser to complete payment; the balance updates after the webhook fires. Minimum $10, maximum $10,000 per checkout.

## Request body

- object
  - `amount` number, required

## Response `200`

OK

- object
  - `success` true, required
  - `data` object, required
    - `checkout_url` string, uri
    - `session_id` string
    - `amount_usd` number
  - `meta` Meta, required
    - `requestId` string
    - `timestamp` string, date-time

## Other responses

- `400`: Amount out of bounds.

---

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