Get Current Balance

GET

/core/v1/services/{service_id}/balance

The endpoint retrieves the balance information for a specific service identified by the service_id.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://gateway-sandbox.balad.tech/core/v1/services/1/balance' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "data": [
        {
            "balance": 500.00,
            "balance_date": "10-Sep-2025 10:00 AM",
            "currency_description": "QAR"
        },
        {
            "balance": 800.00,
            "balance_date": "30-Jul-2024 10:55 AM",
            "currency_description": "EUR"
        }
    ],
    "errors": null
}

Exchange Rates

Generate Secret