# Get Balance

Retrieve your current Brick balance through the SNAP Disbursement contract.

`GET /v2/payments/disbursements/snap/balance`

This endpoint is read-only and does not accept a request body.

## Request headers

| Header | Required | Description |
| --- | --- | --- |
| `Authorization` | Yes | Bearer followed by your SNAP access token. |
| `X-CLIENT-KEY` | Yes | Client ID from Configuration → API Credentials. |
| `X-TIMESTAMP` | Yes | RFC3339 / ISO 8601 timestamp with a timezone, within plus or minus 10 minutes of server time. |
| `X-SIGNATURE` | Yes | Request signature for the Get Balance request. See [Setup Client Key and Signature](/brickfast-disbursement/snap/setup-client-key-and-signature). |
| `X-REFERENCE-ID` | Yes | A new UUID identifying this request. |

## Retrieve balance

**Request · cURL**

```bash
curl --request GET \
  --url '{{base_url}}/v2/payments/disbursements/snap/balance' \
  --header 'Authorization: Bearer snap_demo_20261020_83ac67125b8f' \
  --header 'X-CLIENT-KEY: 83ac6712-5b8f-4b0d-9e24-63aa79102d45' \
  --header 'X-TIMESTAMP: 2026-10-20T09:00:00+07:00' \
  --header 'X-SIGNATURE: U05BUC1ET0NTLUVYQU1QTEUtU0lHTkFUVVJFLU5PVC1GT1ItQVVUSA==' \
  --header 'X-REFERENCE-ID: 61fd8e9b-4c37-4d5a-83bd-2b4589c0a621'
```

**Response · HTTP 200**

```json
{
  "responseCode": "2001100",
  "responseMessage": "Successful",
  "accountInfos": [
    {
      "balanceType": "Cash",
      "amount": {
        "value": "10100380255.00",
        "currency": "IDR"
      },
      "floatAmount": {
        "value": "1000000.00",
        "currency": "IDR"
      },
      "availableBalance": {
        "value": "10099380255.00",
        "currency": "IDR"
      }
    }
  ],
  "additionalInfo": {
    "source": "API",
    "entity": "Payment",
    "sameDaySettlement": {
      "isActive": true,
      "earlySettlementBalanceQuota": {
        "value": "500000.00",
        "currency": "IDR"
      }
    }
  }
}
```

## Response fields

| Field | Type | Description |
| --- | --- | --- |
| `responseCode` | string | `2001100` for a successful balance retrieval. |
| `responseMessage` | string | API response description. |
| `accountInfos` | array | Balance information for the account. |
| `accountInfos[].balanceType` | string | Balance type, for example `Cash`. |
| `accountInfos[].amount` | object | Total Balance. |
| `accountInfos[].floatAmount` | object | Pending Balance. |
| `accountInfos[].availableBalance` | object | Usable Balance. |
| `*.value` | string | Amount with exactly two decimal places. |
| `*.currency` | string | Currency code: `IDR`. |
| `additionalInfo.source` | string | Balance data source. |
| `additionalInfo.entity` | string | Entity associated with the balance. |
| `additionalInfo.sameDaySettlement.isActive` | boolean | Whether Same Day Settlement is active. |
| `additionalInfo.sameDaySettlement.earlySettlementBalanceQuota` | object | Early Settlement Balance Quota. |

## Error responses

| Condition | HTTP status | responseCode | responseMessage |
| --- | --- | --- | --- |
| Invalid access token | 401 | `4010103` | `Token Not Found (B2B)` |
| Invalid request signature | 401 | `4010100` | `Unauthorized. X-SIGNATURE does not match the registered public key and request payload` |
| Malformed or out-of-window timestamp | 401 | `4011100` | `Unauthorized. X-TIMESTAMP must be RFC3339 and within ten minutes of server time` |

For request recovery guidance, see [Error Handling](/brickfast-disbursement/snap/error-handling).