> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rapidtopup.com.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Wallet Balance

> Check your current available reseller balance in NGN before initiating transactions.

## Request

**Authorization** `string` *required*

Bearer token: `Bearer <api-key>`

```bash cURL theme={null}
curl --request GET \
  --url https://api.rapidtopup.com.ng/api/v2/b2b/balance \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <api-key>'
```

```javascript JavaScript (Fetch) theme={null}
const response = await fetch('https://api.rapidtopup.com.ng/api/v2/b2b/balance', {
  method: 'GET',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer <api-key>',
  },
});

const data = await response.json();
console.log(data);
// { status: 'success', data: { balance: '45000.50', currency: 'NGN' } }
```

```php PHP (Guzzle) theme={null}
<?php

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://api.rapidtopup.com.ng/api/v2/b2b/balance', [
    'headers' => [
        'Accept'        => 'application/json',
        'Authorization' => 'Bearer <api-key>',
    ],
]);

$data = json_decode($response->getBody(), true);
echo $data['data']['balance']; // "45000.50"
```

***

## Response

**status** `string`

`success`

**data** `object`

**data fields**

**balance** `string`

Your current available wallet balance in NGN, formatted as a decimal string. E.g. `"45000.50"`

**currency** `string`

Always `"NGN"`

**✅ Success `200`:**

```json theme={null}
{
  "status": "success",
  "data": {
    "balance": "45000.50",
    "currency": "NGN"
  }
}
```

**❌ Unauthorized `401`:**

```json theme={null}
{
  "status": "error",
  "message": "Unauthorized. Invalid or missing API key format."
}
```

> [!TIP]
>
> Always check your balance before initiating bulk purchases to avoid partial failures from insufficient funds midway through a batch.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.