Envelope
Every JSON response is wrapped in a standard envelope. The body field carries the actual payload; the surrounding keys are metadata (version, status code, request id, and — on paginated endpoints — a pagination block).
This shape keeps the body abstract so the wrapper is easy to see. Every endpoint returns these envelope keys around its own body:
GET
Envelope fields
- version — API version string.
- code / status — HTTP status code and its text.
- request_id — opaque id for the request; quote it in bug reports.
- elapsed — server-side processing time in seconds.
- pagination — present only on list endpoints (see Pagination).
- body — the actual payload. Its shape is documented on each endpoint's own page.
Condensing
All endpoints support the global &condense=true|false option. When true, all null values are removed from the response; otherwise every possible key is included. It defaults to true.
condense is a boolean, so true/false, 1/0, and yes/no are all accepted.
GET