Skip to main content
The Data City API uses standard HTTP status codes. Every error response shares a single JSON envelope.

Error envelope

The message field is intended for log lines and developer diagnostics. Don’t surface it verbatim to end users. Phrasing may change between releases.

Status code matrix

Retrying

Retry 429, 500, 502, 503, and 504 with exponential backoff. Do not auto-retry 400, 401, 403, 404, or 422. The request will fail again the same way.
Last modified on October 7, 2026