---
title: "Checkout link to add money to the balance"
method: POST
path: "/wallet/topup"
tags: ["Balance"]
---

# Checkout link to add money to the balance

`POST /wallet/topup`

## Request

- Base URL: `https://api.phoenixlabs.space`
- URL: `https://api.phoenixlabs.space/wallet/topup`
- Auth: HTTP bearer

## Request body

- object
  - `amount_cents` integer, required
  - `email` string

## Response `200`

checkout_url for the person paying.

- object

## Other responses

- `400`: Bad input. `detail` says what to fix.
- `401`: Missing or unrecognised key.
- `402`: The balance, or the agent key's limit, doesn't cover the price. `needs_topup` or `over_limit` says which.

---

[API](https://skmtc.dev/phoenixlabs/apis/phoenix-labs-api.md) · [All operations](https://skmtc.dev/phoenixlabs/apis/phoenix-labs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/phoenixlabs/apis/phoenix-labs-api/revisions/7648b94d8dd2?raw)