Errors
Every error has the same shape, with a stable code to act on and a message for people.
403
{
"error": { "code": "upgrade_required", "message": "This needs the Race Pass.",
"plan": "Race Pass", "docs": "https://greyhoundracingapi.com/documentation/errors" }
}| HTTP | Code | What to do |
|---|---|---|
| 400 | bad_request | A value is not valid, a date is before 2020, or the key was put in the address. The message says which. |
| 401 | unauthorized | No key, or the key is wrong, revoked or expired. Check the header. |
| 403 | upgrade_required | Your plan does not include this endpoint. plan names the one that does. |
| 404 | not_found | No endpoint at that address. Check the path. |
| 422 | unknown_parameter | A parameter this endpoint does not take. The message lists the ones it does. |
| 429 | rate_limited | Too many calls this minute. Wait for Retry-After. |
| 429 | quota_exceeded | Today's allowance is used. It resets at 00:00 UTC. |
| 503 | server_error | Our side. Not counted against you. Try again shortly, and see status. |