Skip to content

Balance ​

Retrieve the current balance of your Pine Labs account. This endpoint provides real-time access to your account details, including balance, account name, and access level.

INFO

The balance returned includes pending transactions. For a detailed breakdown, see Balance Statement or view it from the Dashboard.

API Endpoint ​

http
GET https://api.iimmpact.com/v2/balance

Request Headers ​

HeaderDescriptionRequired
X-Api-KeyYour API keyYes
X-TimestampUnix timestamp in secondsYes
X-NonceUnique request identifierYes
X-SignatureHMAC-SHA256 signature (v1=...)Yes

See API Key Authentication for how to sign your requests.

Response 200 ​

FieldTypeDescription
dataobjectThe data parameter contains the requested data associated with the user. It provides information such as account details, transaction history, or other relevant data.
data.accountstringUser's account number
data.namestringUser's name
data.balancenumberUser's current balance
data.levelstringUser's unique pricing group within the system
data.accessnumber0 = full access (can execute payments via /v2/topup), 50 = read-only access

Example Response:

json
{
  "data": {
    "account": "00000",
    "name": "Demo",
    "balance": 48.6333,
    "level": "12",
    "access": 0
  }
}

Pine Labs API Documentation