# Balance Info

Get balance info

Endpoint: GET /v2/balance
Version: 3.0.0
Security: bearerAuth

## Security:

  - `bearerAuth` (unknown)
    http bearer JWT

## Query parameters:

  - `country` (string, required)
    Destination country

## Response 200:

  - `200` (unknown)
    Successful Response

## Response 200 fields (application/json):

  - `currency` (string, required)
    The destination country's local currency; `balance` is in it.

  - `balance` (number, required)
    What you can pay out to this country right now, in `currency`. Check it before a payout.

  - `reserved_balance` (any)
    Held by payments still in progress, in `wallet_currency`. `balance` and `wallet_balance` already exclude it.

  - `wallet_currency` (string)
    Your settlement wallet currency: `USD`, `USDT` or `USDC`.

  - `wallet_currency_rate` (number)
    Rate from `wallet_currency` to `currency`.

  - `wallet_balance` (number)
    The same funds as `balance`, in `wallet_currency`, including any credit line.

  - `deals` (any)
    Your rate-lock deal position for this corridor, in `wallet_currency`. Absent when you have no active deals.

  - `deals.committed` (number)
    Total approved amount across active deals in this corridor

  - `deals.settled` (number)
    Of `committed`, how much has already been deducted from the ledger by payments that settled against those deals. The difference is what is still withheld from the spendable balance -- the settled part is not withheld again

## Response 400:

  - `400` (unknown)
    Bad data in the request

## Response 400 fields (application/json):

  - `detail` (any)

## Response 401:

  - `401` (unknown)
    Access token not valid or expired

## Response 401 fields (application/json):

  - `detail` (any)

## Response 403:

  - `403` (unknown)
    Access token missing permissions to access the resource

## Response 403 fields (application/json):

  - `detail` (any)

## Response 429:

  - `429` (unknown)
    Request rate is too high; back off and retry. Where a `retry-after` response header is present it gives the number of seconds to wait.

## Response 429 fields (application/json):

  - `detail` (any)

## Response 500:

  - `500` (unknown)
    Internal server error (contact administrator)

## Response 500 fields (application/json):

  - `detail` (any)