Skip to content

Balances

What you can pay out, per corridor.

Operations

Get Balance

Request

Balance info

Security
bearerAuth
Query
countrystring(ApiCountry)required

Payment country

Enum:"BGD""IND""PAK""PHL""NPL""EGY""VNM""NGA"
curl -i -X GET \
  'https://docs.swiftxpay.com/_mock/openapi/v3/balance?country=BGD' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Successful Response

Bodyapplication/json
currencystring(Currency)required

The corridor's local currency; available, reserved and total are in it.

availablenumber(Available)required

What you can pay out now, in currency. Already net of reserved.

reservednumber(Reserved)

Held by payments still in progress, on either API version, in currency.

Default:0
totalnumber(Total)required

available plus reserved, in currency.

walletobject(WalletBalanceInfo)required

The same position in your wallet currency.

dealsLocalBalanceInfo (object) or null
Any of:

Local currency bought through deals, which pays for payments sent without a quote. Absent until a deal has been executed in this corridor.

Response
{
  "currency": "string",
  "available": 0,
  "reserved": 0,
  "total": 0,
  "wallet": {
    "currency": "USD",
    "rate": 0,
    "balance": 0
  },
  "deals": {
    "currency": "BDT",
    "available": 0,
    "reserved": 0,
    "total": 0
  }
}