Watsy
Project endpointsGet balance

Project endpoints

Get balance

The wallet balance of the key's project.

GEThttps://watsy.me/v1/balance
curl https://watsy.me/v1/balance \
  -H "Authorization: Bearer $WATSY_KEY"
{
  "object": "balance",
  "mode": "live",
  "currency": "IQD",
  "balance_milli": 2980000,
  "balance": 2980
}

Authorization

  • Authorizationstring (header)required

    Bearer followed by your project key: wsy_live_… or wsy_test_….

Headers

  • X-Request-Idstring

    Optional, 8 to 64 characters. Echoed back; generated when missing.

Response (200)

application/json
  • objectstringrequired

    Always balance.

  • modestringrequired

    Mode of the key used.

    Values:livetest

  • currencystringrequired

    Always IQD.

  • balance_milliintegerrequired

    Balance in milli-IQD.

  • balancenumberrequired

    The same balance in IQD.

A project has one wallet. A test key sees the same real balance but never charges it.