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	`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.
404	`result_not_available`	Race exists but has not completed; response includes its current status.
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.