Errors

All errors use a consistent envelope:

{
  "error": {
    "code": "document_not_found",
    "message": "No document matched id '01INVALID000000000000000000'. Use browseRegulatoryLibrary with the user's original phrasing to find the correct id."
  }
}

• code is stable and machine-readable
• message is written for an agent deciding what to do next

Error Codes

HTTP	Code	When	What to do
400	validation_error	Query or path parameter failed validation	Fix the named parameter and retry
400	invalid_cursor	Cursor is malformed, expired, or belongs to a different query/filter set	Drop the cursor and restart from the first page
404	document_not_found	ID does not resolve to a document in v1	Search again using the original phrasing
409	document_not_ready	Document is in the catalog but full text is not yet available	Retry later or use another search result
500	internal_error	Unexpected server failure	Retry later; do not expose internals

Note

Authentication, authorization, billing, and quota errors may be added by the platform layer using the same envelope, but they are not part of this feature contract.