---
title: "Token balance"
method: GET
path: "/v1/tokens"
tags: ["account"]
---

# Token balance

`GET /v1/tokens`

## Request

- Base URL: `https://api.close.city`
- URL: `https://api.close.city/v1/tokens`
- Auth: HTTP bearer

The current token balance of the presented API key's account. Requires
a key and counts toward the per-key rate limit, but never charges tokens,
so a zero-balance key can always check.

## Response `200`

Successful Response

- TokensResponse: GET /v1/tokens (routers.tokens.token_balance)
  - `tokens_remaining` integer, required: Current prepaid token balance of the key's account

## Other responses

- `401`: Missing or invalid API key (missing-key, invalid-key)
- `403`: Key disabled (account-disabled)
- `429`: Rate limited or token balance exhausted (rate-limited, tokens-exhausted); sets Retry-After

---

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