Getting started

Errors

Errors return a JSON body with one sentence in detail, written for people. An upstream failure is always an error, never an empty result.

Status	When	Retry
`400`	A parameter is out of range, a field is unknown or the query can't be read	No
`401`	The key is missing or wrong	No
`404`	The document doesn't exist	No
`409`	Prior art has no seed or cutoff date for this document	No
`429`	Too many requests	Yes, after a wait
`502` `503` `504`	The search backend failed, is starting or timed out	Yes

400 Bad request400page=99

{
  "detail": "page: Input should be less than or equal to 40"
}

404 Not found404/v1/patents/US1X

{
  "detail": "That is not a patentgrep document id."
}

Query errors

Exact words queries that can't be parsed, and PatentsView queries that name an unknown field, explain what went wrong. Unknown-field errors list the fields that do exist.

400 Unknown field400q: {"patent_titel": "x"}

{
  "detail": "Unknown patent field 'patent_titel'. Known fields: applicants.applican…"
}