Balance

Every request goes to https://api.lemak.cash. About the reference.

Balance

GET /v1/balance

Authentication

Bearer key. The merchant API key, sk_live_ or sk_test_. It reaches /v1 alone. A test key works from the moment the merchant exists. A live key answers 403 live_not_enabled until the merchant's review opens live mode, before any rate limit is spent.

Parameters

Name	In	Type	Description
`Api-Version` optional	header	string	The version this request is answered at. Absent, the account's pinned version applies, and an account is pinned to info.version on its first request. A version this service does not render is refused with 400 invalid_api_version. api/CHANGELOG.md lists every version. Pattern `^[0-9]{4}-[0-9]{2}-[0-9]{2}$`.

Responses

200

The merchant balance, one entry per currency in each bucket.

application/json

Balance

Field Type Description

available required

array of Money

Fields of available

Field	Type	Description
`amount` required	integer (int64)	Minor units. Never a decimal.
`currency` required	string	Pattern `^[A-Z]{3}$`.

pending required

array of Money

Fields of pending

Field	Type	Description
`amount` required	integer (int64)	Minor units. Never a decimal.
`currency` required	string	Pattern `^[A-Z]{3}$`.

dispute_hold required

array of Money

Fields of dispute_hold

Field	Type	Description
`amount` required	integer (int64)	Minor units. Never a decimal.
`currency` required	string	Pattern `^[A-Z]{3}$`.

Errors

Every error answers with the error object.

Status	When
Other	400 bad parameter, 401 authentication, 402 payment failed, 403 forbidden, 404 not found, 409 conflict, 413 request_too_large (a body over 64 KiB), 422 idempotency key reused, 429 rate limited, 5xx api error.

Example

curl https://api.lemak.cash/v1/balance \
  -H "Authorization: Bearer sk_test_..." \
  -H "Api-Version: 2026-09-01"