Drex

Get the balance

It answers at any balance, including zero and while a payment is overdue, and it is never billed. It has its own requests-per-minute window, the same size as the document routes', so reading it does not slow your other requests. An OAuth access token needs the account:read scope.

GET
/v1/balance

It answers at any balance, including zero and while a payment is overdue, and it is never billed. It has its own requests-per-minute window, the same size as the document routes', so reading it does not slow your other requests. An OAuth access token needs the account:read scope.

Authorization

bearerAuth
AuthorizationBearer <token>

Your API key, sent as Authorization: Bearer nace_sk_...

  • Where: the dashboard's API Keys page. It is shown once, when you create it.
  • Format: nace_sk_ followed by 43 URL-safe characters (A-Z, a-z, 0-9, _ and -).
  • Limit: an account can hold at most 3 active keys.
  • Wrong or missing key: returns 401 authentication_error.

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/balance"
{  "object": "balance",  "available_usd": 4.871234567,  "available_nusd": 4871234567,  "held_usd": 0.25,  "held_nusd": 250000000,  "pay_as_you_go": false,  "payment_required": false,  "as_of": "2026-11-16T12:00:00.000Z",  "request_id": "req_0123456789abcdef0123456789abcdef"}