/
4.1.6 Balance

4.1.6 Balance

Owned by Tomasz Kozierowski
Last updated: Feb 26, 2025 by Piotr Mrozek

Balance

URL: /balance.ashx

The method returns an object containing the current account balance as a string ready for display. It already contains a properly formatted amount along with a currency symbol. Formatting is based on the currency of the user account.

Parameter

Description

l

Login - login of SIP account

p

Password - password of SIP account

cURL Request Example

--header 'User-Agent: vippie;ios;1.2.3' \
--header 'Content-Type: text/plain' \
--header 'Authorization: Basic YW5kOmFuZDJhMzJkaW0=' \
--header 'X-VIPPIE-DEVICE-ID: ff66fc693846285d' \
--header 'X-VIPPIE-DEVICE-NAME: iPhone8,1'


In response we receive JSON:

{
  "bt": "$0.96",
  "bv": 0.96,
  "bc": "USD",
  "bn": [
    {
      "btp": "Bonus India 60",
      "min": 58
    },
    {
      "btp": "Bonus USA 100",
      "min": 75.5
    },
    {
      "btp": "Bonus Word 5",
      "min": 5
    }
  ]
}

If an error occurs on the server or any of the parameters contain an incorrect value, the method will return the appropriate 3-digit error code shown below:

Code

Description

400

Incorrect parameters - one of the parameters was not provided

404

Invalid HTTP method - only POST method accepted

406

The login and/or password are incorrect

500

Internal server error

Related content