Copy page

SNAP Disbursement

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.
X-REFERENCE-ID	Yes	A new UUID identifying this request.

Retrieve balance

Request · cURL

Code
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

Code
{
  "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.