API Reference › Account › Get account

Free · account read

POST/get_account

Get account

Return the authenticated account profile, plan tier, and token balances. Never charged.

Request body

Empty object

Bearer auth required

Send an empty JSON object. No request parameters are required.

Response

application/json

A processed request returns status: "ok". The nested result may be empty; in that case tokens_charged remains zero.

results.account_id

Stable account identifier.

results.plan

Current subscription plan.

results.tokens_remaining

Remaining included tokens.

metadata.tokens_charged

Credits charged for the returned result. Zero for a miss.

metadata.fair_use

Remaining records and reset timestamps for applicable plan windows.

400

Malformed request body

401

Missing or invalid API key

422

Unsupported filter value

429

Rate limit exceeded