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.