Errors

The GreyhoundAPI error shape, every error code the API returns and the HTTP statuses to expect for each.

Errors are JSON with a stable shape and a documentation link:

{ "error": { "code": "rate_limited",
  "message": "120 requests/minute exceeded. Retry after 21s.",
  "doc_url": "https://greyhoundapi.com/documentation/errors" } }

HTTP	Code	Meaning
401	`unauthorized`	Missing or unknown key.
403	`key_suspended`	Key exists but its subscription has lapsed.
403	`upgrade_required`	Your key’s tier does not reach this endpoint. The payload names the tier you hold and the one you need, the monthly price, and — where one exists — a `try_instead` endpoint that works on the key you already have.
403	`outside_sandbox_window`	Sandbox key requested data outside its window.
404	`not_found`	No such resource.
405	`method_not_allowed`	The API is read-only; every endpoint is GET.
409	`result_not_available`	The race exists but has no result yet. Carries its current `status` and a `retry` flag — `true` while it is still to run, `false` once it has run and stalled. A race confirmed as never run returns `200` instead, with `result_available: false`.
400	`invalid_id`	An id in a `ids` batch has no record, or there are more than 50. The whole request is refused and the offending ids are listed in `ids`.
422	`invalid_param`	A parameter failed validation; the message names it.
429	`rate_limited`	Per-minute limit exceeded.
429	`quota_exceeded`	Monthly (live) or daily (sandbox) quota exhausted.
500	`server_error`	Our side. Safe to retry with backoff.
501	`not_implemented`	Documented but not yet live — pre-launch only.