Prisradar
Basics

API errors and what they mean

Every error has a fixed code for your software and a German sentence for your log. Requests with an error never count towards the quota.

Updated on 21.10.2026The Prisradar team

On this page
Response 404
{
  "error": {
    "code": "unknown_make",
    "message": "Die Marke «Ferari» kennen wir nicht.",
    "suggestions": [
      "Ferrari"
    ]
  }
}
Response 429
{
  "error": {
    "code": "quota_exceeded",
    "message": "Das Kontingent von 2000 Bewertungen ist für diesen Monat aufgebraucht.",
    "resetsAt": "2026-10-31T23:00:00.000Z"
  }
}

What does an error look like?

Every error comes as JSON with the error object. error.code is a fixed English code that your software reacts to. error.message is a German sentence for your log. Some errors bring more: error.field, error.suggestions or error.resetsAt. An error never counts towards the quota.

Which errors are there?

400 means a field is missing or wrong. 401 and 403 concern the key. 404 means the make or model is not in the catalogue. 422 means there is no reliable value. 429 means too fast or quota used up. 503 means the API is briefly paused.

FieldTypeMeaning
400invalid_requestA field is missing or wrong; error.field names it.
401unauthorizedKey missing, wrong or revoked, or the access is paused.
403forbiddenRequest from a server address that is not allowed for the key.
404unknown_make · unknown_modelNot in the catalogue; error.suggestions lists similar names.
422too_few_comparables · too_oldNo reliable value: too few comparisons or older than 25 years.
429rate_limited · quota_exceededToo fast, or the quota is used up; Retry-After or error.resetsAt says when it continues.
503unavailableThe API is briefly paused. Try again after a few minutes.

What should I do about error 429?

Check error.code. With rate_limited you have sent more than 60 requests in one minute; wait for the seconds in the Retry-After header. With quota_exceeded the month’s quota is used up; it continues on the date in error.resetsAt, or straight away with a larger package. If error.resetsAt is missing, there is no package or its payment is open; error.message says what helps.

Packages and limits: Limits and packages.

When should my software try again?

Only with 429 rate_limited and with 503, and only after the time in the Retry-After header. All other errors come back with the same request: with 400 correct the field, with 404 the name, and with 422 show a note instead of a value.

Didn’t find what you’re looking for?Write to info@prisradar.ch or use the contact form.

Type what you’re looking for: a feature, a question or an error code.

↑ ↓ select↵ openEsc close