Skip to main content
Hanto returns JSON error bodies for failed API requests. A 404 no-match response is a completed lookup result, not a transport failure.

Response outcomes

Rate limit

The public API allows up to 500 requests per minute per workspace. When the API returns 429, use the response headers to decide when to retry:

Retry guidance

  • Do not retry 400 or 401 responses until the request or key is corrected.
  • Treat 404 as a final no-match result.
  • Retry 429 after Retry-After.
  • Retry 502, 503, and other 5xx responses with backoff.