---
title: "Top Up Agent Credits"
method: POST
path: "/v1/agent-topup"
---

# Top Up Agent Credits

`POST /v1/agent-topup`

## Request

- Base URL: `https://licenseground.com` (the document declares no server; this is the origin it was published from)
- URL: `https://licenseground.com/v1/agent-topup`
- Auth: none declared

Top up credit balance for an agent key.

## Request body

- TopUpCreditsRequest
  - `api_key` string, required
  - `credits` integer
  - `payment_reference` string

## Response `200`

Successful Response

- MeterStatus: Credits and usage metering information for agent accounts.
  - `api_key` string, required
  - `remaining_credits` integer, required
  - `total_used` integer, required
  - `spending_ceiling_usd` number, required
  - `current_spend_usd` number, required
  - `is_active` boolean, required

## Other responses

- `422`: Validation Error

---

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