GET/v1/balance

Get balance, held and available

Returns the balance triple: balance (settled funds), held (reservations for in-flight runs), and available (balance minus held — the number a new run is admitted against). This is also the cheapest authentication probe.

Request

bash

curl -X GET https://api.glasser.ai/v1/balance \
  -H "Authorization: Bearer gl_..."

Response

200

balance_usdstringrequired

Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.

held_usdstringrequired

Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.

available_usdstringrequired

Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.

Errors

400validation_failedThe request does not satisfy the schema. details.issues lists the fields that failed, and details.location names the part of the request that carried them: Payload, Headers, Path, or Query.

401unauthorizedThe API key is missing, malformed, revoked, or unknown.

429rate_limitedThe rate limit is exceeded. error.retry_after_ms tells you how long to wait.

500internal_errorThe server failed. The response body does not include internal details.

Authentication

Requires Bearer authentication. The workspace is bound to the API key, and you cannot change it with a request header.

Authorization: Bearer gl_...

Base URL: https://api.glasser.ai