Skip to navigation

Errors

Status codes and the shape of an error.
View as Markdown

Errors use standard HTTP status codes and a JSON body with a detail field:

{ "detail": "tracked item not found" }

For a request body that fails validation (422), detail is a list naming each field and what is wrong with it:

{
"detail": [
{
"loc": ["body", "poll_interval_minutes"],
"msg": "Input should be greater than or equal to 1",
"type": "greater_than_equal"
}
]
}
StatusMeaning
400The request is not acceptable as sent; detail says why.
401Missing, wrong or revoked API key.
402Past a plan limit, such as the number of tracked listings.
403The key may not do this (read-only, or the plan has no API access).
404Not found, or not yours: other accounts’ records always look absent.
409Conflicts with something that exists, such as a listing already tracked.
422The body failed validation. Numbers must be finite and below 1,000,000,000,000.
429Rate limited; wait Retry-After seconds.
5xxSomething failed on our side. Retry later, with backoff.