API error reference

HTTP statuses, JSON problem details, meanings, and next steps for DistrictFacts API errors.

Keyed errors use JSON problem details with type, title, status, detail and request_id.

key_in_query — HTTP 400

API key in query string. API keys must be sent in the Authorization or X-API-Key header, never in a URL.

missing_key — HTTP 401

API key required. Send an API key in Authorization: Bearer <key> or X-API-Key.

invalid_key — HTTP 401

Invalid API key. The API key is invalid.

key_revoked — HTTP 403

API key revoked. This API key has been revoked.

developer_suspended — HTTP 403

Developer account suspended. This developer account is suspended.

terms_update_required — Not in use yet

Terms update required. Reserved code. The current handler does not return it.

rate_limited — HTTP 429

Rate limit exceeded. The API key has exceeded its rate limit.

not_found — HTTP 404

Not found. The requested API resource does not exist.

method_not_allowed — HTTP 405

Method not allowed. Use GET or HEAD for API resources.

internal — HTTP 500

Internal server error. The requested API resource could not be read.

not_entitled — Not in use yet

Not included in this key’s plan. Reserved code. There is no paid tier and the current handler does not return it.

feed_range_expired — Not in use yet

Change history not available that far back. Reserved code. There is no change feed and the current handler does not return it.

Developer documentation