---
title: "Wallet balances"
method: GET
path: "/v2/wallet-balances"
tags: ["finances"]
---

# Wallet balances

`GET /v2/wallet-balances`

## Request

- Base URL: `https://api.sandbox.pawapay.io`
- URL: `https://api.sandbox.pawapay.io/v2/wallet-balances`
- Auth: HTTP bearer

## Query parameters

- `country` string

## Response `200`

Request has been succesfully processed.

- CheckBalanceResponse
  - `balances` WalletState[], required: List of wallet balances
    - `country` string, text, required: Country of the wallet. Format is ISO 3166-1 alpha-3, three character country code in upper case. Read more from [Wikipedia](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3#Officially_assigned_code_elements).
    - `balance` string, required: The current balance of the wallet.
    - `currency` string, text, required: Currency of the wallet.
    - `provider` string, required: If you are using a wallet that is only used by a single provider, that providers code will be shown here.

## Other responses

- `401`: Authentication failed. Make sure you have added the API token into the header. If using signatures, make sure they are valid.
- `403`: Authorization failure. Please check your authentication token.
- `500`: An unknown failure has occurred.

---

[API](https://skmtc.dev/pawapay/apis/pawapay-merchant-api-v2.md) - [All operations](https://skmtc.dev/pawapay/apis/pawapay-merchant-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/pawapay/apis/pawapay-merchant-api-v2/revisions/4556d2ec2141?raw)