ReferenceReference · Information-oriented

Errors and status codes

What each status code means in BINA, and the machine codes you can match on.

Every error body has an error sentence for people. Where a client might branch, it also has a stable code.

#Status codes

Status	Meaning in BINA
`200`	Read succeeded, or an identical completed run was reused.
`201`	A record was created (party, watch, signal, similar decision).
`202`	Background work started: an ingest or an extraction run. Follow `statusPath`.
`400`	The body or query failed validation. The sentence says which field.
`401`	Authentication required (`operator_auth_required`) or the review password is missing.
`403`	Disallowed `Origin`, or an attribution field that does not match the authenticated operator.
`404`	Unknown document, case, recital, party, run, watch — or `No route.`
`409`	Conflicting state: already reviewed, ingest running, server offline, no DMA/cartel decision for the case.
`413`	Body larger than the limit.
`415`	`Content-Type` is not `application/json`.
`421`	`Host` header is not in the allowlist.
`422`	A quote failed verification. This is the expected answer to an invented quote.
`501`	Not available in the hosted review workspace (bulk ingest, registry enrichment, webhook delivery).
`503`	No extraction provider is configured.

#Quote gate codes (`422`)

Code	Meaning	Fix
`no_such_recital`	The recital number does not exist in the stored decision text.	Check the number with `GET …/recitals`.
`quote_too_short`	Fewer than 8 characters after folding.	Quote a longer passage.
`quote_not_in_recital`	The quote is not word for word in that recital.	Copy the passage exactly; search with `?q=`.
`name_not_in_quote`	The party's name does not occur in its supporting quote.	Quote the passage where the name appears.

#Other codes

Code	Status	Meaning
`operator_auth_required`	`401`	A write needs a valid operator token.
`password_required`	`401`	The review workspace needs `X-Bina-Password`.