---
title: "Get account balance"
method: POST
path: "/getBalance"
tags: ["Account"]
---

# Get account balance

`POST /getBalance`

Returns the current credit balance of the account identified by `clientKey`.

## Request body

- GetBalanceRequest
  - `clientKey` string, required — Your account API key (from https://dash.capmonster.cloud). Authenticates the request.

## Response `200`

Current balance, or an error.

- GetBalanceResponse
  - `errorId` integer, required — `0` = success, non-zero = error.
  - `errorCode` 'ERROR_KEY_DOES_NOT_EXIST' | 'ERROR_ZERO_BALANCE' | 'ERROR_TOO_BIG_CAPTCHA_FILESIZE' | 'ERROR_ZERO_CAPTCHA_FILESIZE' | 'ERROR_NO_SUCH_CAPCHA_ID' | 'WRONG_CAPTCHA_ID' | 'ERROR_CAPTCHA_UNSOLVABLE' | 'CAPTCHA_NOT_READY' | 'ERROR_IP_NOT_ALLOWED' | 'ERROR_IP_BANNED' | 'ERROR_NO_SUCH_METHOD' | 'ERROR_TOO_MUCH_REQUESTS' | 'ERROR_DOMAIN_NOT_ALLOWED' | 'ERROR_TOKEN_EXPIRED' | 'ERROR_NO_SLOT_AVAILABLE' | 'ERROR_RECAPTCHA_INVALID_SITEKEY' | 'ERROR_RECAPTCHA_INVALID_DOMAIN' | 'ERROR_RECAPTCHA_TIMEOUT' | 'ERROR_IP_BLOCKED' | 'ERROR_PROXY_CONNECT_REFUSED' | 'ERROR_PROXY_BANNED' | 'ERROR_PROXY_MISSING' | 'ERROR_PROXY_NOT_AUTHORISED' | 'ERROR_PROXY_READ_TIMEOUT' | 'ERROR_TASK_NOT_SUPPORTED' | 'ERROR_TASK_ABSENT' | 'ERROR_WRONG_USERAGENT' — Machine-readable error code returned when `errorId` is non-zero.
  - `errorDescription` string, nullable
  - `balance` number — Available account balance (credits). Present on success.

## Other responses

- `403` — Invalid / unknown API key (`ERROR_KEY_DOES_NOT_EXIST`).

---

[API](https://skmtc.dev/capmonster/apis/capmonster-cloud-api-createtask-gettaskresult-getbalance.md) · [All operations](https://skmtc.dev/capmonster/apis/capmonster-cloud-api-createtask-gettaskresult-getbalance/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/capmonster/capmonster-cloud-api-createtask-gettaskresult-getbalance/revisions/d742f6de22b5/schema)