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

# Check Balance

> Melihat sisa saldo akun reseller Anda saat ini secara real-time dari hitungan detik.

Langkah pertama dalam integrasi biasanya adalah mengecek fungsionalitas dan saldo akun Anda. Endpoint ini mengembalikan sisa saldo (balance) Anda secara rinci, dan mata uang (currency) sistem yang sedang digunakan yaitu IDR.

> **Tips Pengembangan:** Sebaiknya integrasikan *request* endpoint balance sewaktu pengguna Anda masuk halaman Dashboard, namun hindari memanggil endpoint ini terlalu sering (misalnya setiap beberapa detik sekali/looping brutal) menggunakan *cron job*. Gunakan endpoint ini di panel admin Anda sebagai laporan saldo Provider.

## Query Parameters

Anda hanya perlu mengirimkan API Key di Header atau sebagai query parameter. Tidak ada form parameters lain yang diperlukan.

<ParamField query="api_key" type="string" required>
  Kunci API Anda (Jika Anda tidak menginginkan menggunakan custom Header `X-Api-Key`).
</ParamField>

## Contoh Request

```bash Request (cURL) theme={null}
curl -X GET -H "X-Api-Key: YOUR_API_KEY_HERE" "https://app.sosmednext.com/api/v1/balance"
```

## Response Data Format

```json Response Berhasil (200 OK) theme={null}
{
  "balance": 150000.50,
  "currency": "IDR"
}
```

### Penjelasan Detil Field:

| Field      | Tipe Data | Keterangan                                                                           |
| :--------- | :-------- | :----------------------------------------------------------------------------------- |
| `balance`  | Number    | Jumlah saldo / balance akun Anda saat ini.                                           |
| `currency` | String    | Mata uang provider sistem kami, secara default akan selalu menampilkan format `IDR`. |