Vobiz Logo
Vobiz
|API Documentation
Console

Balance & Transactions

Retrieve account balance details and transaction history.

Get Transactions

GEThttps://api.vobiz.ai/api/v1/account/{account_id}/transactions

Retrieve a list of transactions for a specific account.

Request

cURL
curl --location 'https://api.vobiz.ai/api/v1/account/YOUR_AUTH_ID/transactions?limit=50&offset=0' \
--header 'X-Auth-ID: YOUR_AUTH_ID' \
--header 'X-Auth-Token: YOUR_AUTH_TOKEN' \
--header 'Accept: application/json'

Response

JSON Reponse
{
    "account_id": "MA_XXXXXX",
    "count": 50,
    "limit": 50,
    "offset": 0,
    "transactions": [
        {
            "id": "6883ee37-4085-465f-97c2-e1c67c50aab9",
            "account_id": "MA_XXXXXX",
            "balance_id": "a84cd3a6-21f4-4b4c-99f2-3d069cb65459",
            "type": "debit",
            "amount": 0.9,
            "currency": "INR",
            "description": "Stream session (70s)",
            "reference": "cdr:e565c2de-975c-4ba5-b115-44b1042cd397",
            "status": "completed",
            "processed_at": "2025-12-08T09:38:06.923988Z",
            "created_at": "2025-12-08T09:38:06.923988Z",
            "updated_at": "2025-12-08T09:38:06.923988Z"
        },
        {
            "id": "6aa3bf01-9158-4f1a-9980-8b3416b57e5a",
            "account_id": "MA_XXXXXX",
            "balance_id": "a84cd3a6-21f4-4b4c-99f2-3d069cb65459",
            "type": "debit",
            "amount": 0.45,
            "currency": "INR",
            "description": "Stream session (30s)",
             "reference": "cdr:...",
             "status": "completed",
             "processed_at": "...",
             "created_at": "...",
             "updated_at": "..."
        }
    ]
}

Get Balance

GEThttps://api.vobiz.ai/api/v1/account/{account_id}/balance/{currency}

Retrieve the balance for a specific account and currency.

Request

cURL
curl --location 'https://api.vobiz.ai/api/v1/account/YOUR_AUTH_ID/balance/INR' \
--header 'X-Auth-ID: YOUR_AUTH_ID' \
--header 'X-Auth-Token: YOUR_AUTH_TOKEN' \
--header 'Accept: application/json'

Response

JSON Response
{
    "id": "a84cd3a6-21f4-4b4c-99f2-3d069cb65459",
    "account_id": "MA_XXXXXX",
    "currency": "INR",
    "balance": 3082.65,
    "reserved_funds": 0,
    "available_balance": 3082.65,
    "credit_limit": 0,
    "low_balance_threshold": 50,
    "status": "active",
    "created_at": "2025-10-17T08:51:01.646973Z",
    "updated_at": "2025-12-08T09:38:06.921968Z"
}
Update Account
Create Subaccount