---
title: "Check account balance"
method: GET
path: "/v1/pay/balance/query"
---

# Check account balance

`GET /v1/pay/balance/query`

Retrieve the payment account balance for the merchant.

## Headers

- `X-GatePay-Certificate-ClientId` string, required
- `X-GatePay-Signature` string, required
- `X-GatePay-Timestamp` string, required
- `X-GatePay-Nonce` string, required

## Response `200`

Success

- BalanceQueryResponse
  - `status` 'SUCCESS' | 'FAIL' — SUCCESS or FAIL
  - `code` string — Error code
  - `errorMessage` string — Error message
  - `data` object
    - `balance_list` BalanceItem[] — List of balances per currency
      - `currency` string — Currency
      - `available` string — Balance of the currency in the merchant's spot account, truncated to 6 decimal places

---

[API](https://skmtc.dev/gate/apis/gatepay-common-api.md) · [All operations](https://skmtc.dev/gate/apis/gatepay-common-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gate/gatepay-common-api/revisions/3dd1d8e41817/schema)