> ## Documentation Index > Fetch the complete documentation index at: https://docs.gnosispay.com/llms.txt > Use this file to discover all available pages before exploring further. # Get account balances > Retrieves the account's current balances, grouped by currency and token. Amounts are integer strings in the smallest unit indicated by `decimals`. Before creating a withdrawal, use the selected token's `max_instant_withdraw` as the current upper bound. ## OpenAPI ````yaml https://core.sandbox.gnosispay.in/partner-api/openapi.json get /v1/accounts/{account_id}/balances openapi: 3.1.0 info: title: Gnosis Pay Partner API version: 1.0.0 description: >- Server-to-server API for onboarding users, creating accounts and cards, moving funds, and managing the card lifecycle. Call this API only from a trusted backend. Every request requires a partner access token, and every resource is scoped to the authenticated partner. servers: - url: https://core.prod.gnosispay.com/partner-api description: Production variables: {} - url: https://core.sandbox.gnosispay.in/core description: Sandbox variables: {} security: - BearerAuth: [] tags: - name: Accounts - name: Cards - name: Card transactions - name: KYC - name: Deposits - name: Withdrawals - name: PCI - name: 3DS - name: Webhooks paths: /v1/accounts/{account_id}/balances: get: tags: - Accounts summary: Get account balances description: >- Retrieves the account's current balances, grouped by currency and token. Amounts are integer strings in the smallest unit indicated by `decimals`. Before creating a withdrawal, use the selected token's `max_instant_withdraw` as the current upper bound. operationId: accounts.get_balances.v1 parameters: - name: account_id in: path required: true description: The account ID. schema: $ref: '#/components/schemas/uuid' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/AccountBalancesResponse' examples: EUR and USD balances: summary: EUR and USD balances description: >- 125.05 EUR spendable, 20.00 EUR on hold and 50.00 EUR deposit in progress; 80.25 USD spendable across USDC and USDT with a 10.00 USD withdrawal in progress. value: data: - currency: EUR decimals: 18 spendable: '125050000000000000000' non_spendable: '20000000000000000000' processing_deposits: '50000000000000000000' processing_withdrawals: '0' tokens: - token: EURe decimals: 18 spendable: '125050000000000000000' non_spendable: '20000000000000000000' processing_deposits: '50000000000000000000' max_instant_withdraw: '145050000000000000000' - currency: USD decimals: 6 spendable: '80250000' non_spendable: '0' processing_deposits: '0' processing_withdrawals: '10000000' tokens: - token: USDC decimals: 6 spendable: '50250000' non_spendable: '0' processing_deposits: '0' max_instant_withdraw: '50250000' - token: USDT decimals: 6 spendable: '30000000' non_spendable: '0' processing_deposits: '0' max_instant_withdraw: '30000000' default: description: An unexpected error response. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: uuid: type: string format: uuid AccountBalancesResponse: type: object required: - data properties: data: type: array items: $ref: '#/components/schemas/AccountBalance' description: List of balances per currency. examples: - data: - currency: EUR decimals: 18 spendable: '125050000000000000000' non_spendable: '20000000000000000000' processing_deposits: '50000000000000000000' processing_withdrawals: '0' tokens: - token: EURe decimals: 18 spendable: '125050000000000000000' non_spendable: '20000000000000000000' processing_deposits: '50000000000000000000' max_instant_withdraw: '145050000000000000000' Error: type: object required: - code - message properties: code: type: integer format: int32 description: HTTP status code. message: type: string description: Generic human-readable text for the status code. Do not parse it. reason: type: string description: >- Stable machine-readable code identifying the specific cause, present only for errors that expose one (e.g. `CREATE_CARD_LIMIT_EXCEEDED`). Branch on this rather than on `message`. AccountBalance: type: object required: - currency - decimals - spendable - non_spendable - processing_deposits - processing_withdrawals - tokens properties: currency: type: string description: Currency code (e.g., "EUR", "USD"). decimals: type: integer format: int32 description: Number of decimal places for this currency's raw amounts. spendable: type: string description: >- Spendable balance. Raw bigint string in the currency's smallest unit. non_spendable: type: string description: >- Amount currently unavailable for spending. Raw bigint string in the currency's smallest unit. processing_deposits: type: string description: >- Incoming amount that is still processing. Raw bigint string in the currency's smallest unit. processing_withdrawals: type: string description: >- Outgoing amount that is still processing. Raw bigint string in the currency's smallest unit. tokens: type: array items: $ref: '#/components/schemas/TokenBalance' description: >- Per-token breakdown of balances. Each entry shows the balance for a specific on-chain token (e.g., USDC, USDT). examples: - currency: EUR decimals: 18 spendable: '125050000000000000000' non_spendable: '20000000000000000000' processing_deposits: '50000000000000000000' processing_withdrawals: '0' tokens: - token: EURe decimals: 18 spendable: '125050000000000000000' non_spendable: '20000000000000000000' processing_deposits: '50000000000000000000' max_instant_withdraw: '145050000000000000000' TokenBalance: type: object required: - token - decimals - spendable - non_spendable - processing_deposits - max_instant_withdraw properties: token: type: string description: Token symbol (e.g., "USDC", "USDT", "EURe"). decimals: type: integer format: int32 description: >- Number of decimal places for this token (e.g., 6 for USDC, 18 for EURe). spendable: type: string description: >- Spendable balance for this token. Raw bigint string in the token's smallest unit. non_spendable: type: string description: >- Amount of this token currently unavailable for spending. Raw bigint string in the token's smallest unit. processing_deposits: type: string description: >- Incoming amount of this token that is still processing. Raw bigint string in the token's smallest unit. max_instant_withdraw: type: string description: >- Maximum amount of this token currently available for an instant withdrawal, expressed as a raw bigint string in the token's smallest unit. Use this value as the upper bound when calling POST /withdrawals. examples: - token: USDC decimals: 6 spendable: '500000000' non_spendable: '50000000' processing_deposits: '25000000' max_instant_withdraw: '550000000' securitySchemes: BearerAuth: type: http scheme: Bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.