---
title: "The prepaid USD balance: total, held for running jobs, available (the spending limit), and today's spend with the daily limit if one is set (\"0.000000\" = none)"
method: GET
path: "/v1/balance"
tags: ["platform-api"]
---

# The prepaid USD balance: total, held for running jobs, available (the spending limit), and today's spend with the daily limit if one is set ("0.000000" = none)

`GET /v1/balance`

## Request

- Base URL: `https://api.cuddler.ai`
- URL: `https://api.cuddler.ai/v1/balance`
- Auth: HTTP bearer

## Response `200`

The balance

- object
  - `object` 'balance', required
  - `currency` 'usd', required
  - `total_usd` string, required
  - `held_usd` string, required
  - `available_usd` string, required
  - `daily_limit_usd` string, required: The organization's daily spending limit (UTC day). "0.000000" means there is no daily limit: spend is bounded by the available balance.
  - `spent_today_usd` string, required
  - `expires_at` string, nullable, required

## Other responses

- `401`: unauthorized — no key, or an unknown or revoked one (WWW-Authenticate: Bearer)
- `403`: organization_suspended — the organization is not active; forbidden — a test key on a live-only route
- `404`: not_found — the Platform API is switched off, or the object does not exist
- `429`: rate_limited — over this key's requests per minute (Retry-After)
- `500`: internal_error — quote request_id when contacting support

---

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