Skip to content

Errors

Status Meaning What to do
200 The feed.
304 Unchanged since your If-None-Match. Keep your copy. See Caching.
400 A filter or the currency is not valid. The body is a message. Fix the query. See Filters and currency.
404 Unknown feed, disabled feed, wrong token or wrong extension. Check the key, token and extension.
503 The catalogue is briefly unavailable. Retry after the number of seconds in the Retry-After header (60).

An unknown feed, a disabled feed, a wrong token and a wrong extension all return the same 404, on purpose: the response never tells a caller which feed keys exist or whether a guessed token was close. If you get a 404 you did not expect, check the key and extension first, then the token.

Retry a 503 once after Retry-After seconds, then fall back to your normal polling interval. Do not retry a 400 or 404 without changing the request.