API error reference

Every error code that the /api/v1/* surface can return. Linked from the doc_url field in the v1.1 wrapped envelope.

HTTP 400
batch_too_large
validation
`/v1/check/batch` enforces a 100-ingredient maximum per call. You sent more.
HTTP 409
idempotency_conflict
idempotency
You sent an `Idempotency-Key` that was used in the last 24 hours with a different request body.
HTTP 403
insufficient_scope
authorization
The API key is valid but lacks the scope required to call this endpoint.
HTTP 500
internal_error
internal
Something went wrong on our side. The `request_id` in the response is the key to debugging.
HTTP 401
invalid_api_key
authentication
The API key you sent is missing, malformed, revoked, or unknown to our system.
HTTP 400
invalid_request
validation
The request body failed validation. The `message` field has the specific reason.
HTTP 402
limit_reached
rate_limit
The key owner's monthly free-plan quota is used up. Pro/Team/Trial accounts are unlimited.
HTTP 404
not_found
validation
The resource you asked for doesn't exist or you don't own it.
HTTP 429
rate_limited
rate_limit
You've hit the per-minute or per-day rate limit configured on this API key.
HTTP 400
unsupported_region
validation
The `region` field must be one of `AU`, `BR`, or `CA`. Anything else returns this error.