Errors
An error is {"error": {"code", "message", "docs"}}, with plan when a plan would allow it. The message is for people; the code is for code, and never changes.
| Code | Status | When |
|---|---|---|
bad_request | 400 | A value is not in its shape: a date, a number, one of a list, or a key in the address |
unauthorized | 401 | The key is not one of ours, or has been revoked |
upgrade_required | 403 | The endpoint needs a Pro Plus key |
not_found | 404 | No such council, meeting, item, paper or endpoint |
unknown_parameter | 422 | A parameter the endpoint does not take: the message lists the ones it does |
rate_limited | 429 | The hourly limit without a key: Retry-After says when it frees up |
quota_exceeded | 429 | A key's month is used up: it resets on the 1st |
server_error | 500 | Our fault; it is logged |
An empty result is not an error: it is a 200 with meta.count at 0.