Account API
Account endpoints are read-only and operate on the organization resolved from the Bearer API key.
| Operation | Endpoint |
|---|---|
| Get balance | GET /v1/account/balance |
| List execution history | GET /v1/account/history |
Balance and cost values are exact decimal strings. Keep them as decimal values rather than converting them through binary floating-point arithmetic.
Execution history is intended for recent operational inspection. Use billing records or exports for long-term financial reconciliation.
History filtering uses raw UTC timestamps. Without request_id, the optional timezone compatibility parameter is validated as an IANA time-zone name but does not transform response timestamps; exact request_id mode ignores it with the other filters. Unknown type values apply no execution-type filter; use multimodal, llm, or api for an effective filter. Unsupported range values fall back to 7d.
History entries can contain stored request parameters and model output. Restrict access to the API key accordingly, and do not copy history responses into logs or support tickets without reviewing them for sensitive data.