Errors and rate limits

401 · Missing, invalid or expired access token

{
  "error": {
    "code": "unauthorized",
    "message": "The access token is missing, invalid or expired."
  }
}

403 · The token does not carry the scope this endpoint needs

{
  "error": {
    "code": "insufficient_scope",
    "message": "This request needs a token with the catalog:read scope."
  }
}

404 · Not found, or not listed on this marketplace

{
  "error": {
    "code": "not_found",
    "message": "No item with that id is listed on this marketplace."
  }
}

409 · The quote has expired (`quote_expired`), an item in it is no longer available (`item_unavailable`), or nothing in it can be bought (`nothing_to_buy`) — create a new quote.

{
  "error": {
    "code": "quote_expired",
    "message": "This quote has expired. Create a new quote to see current prices and availability."
  }
}

422 · The request is invalid; `fields` says which field and why

{
  "error": {
    "code": "validation_failed",
    "message": "The request is invalid. See fields for what to fix.",
    "fields": {
      "per_page": [
        "The per page field must not be greater than 48."
      ]
    }
  }
}

429 · Too many requests; retry after the number of seconds in `Retry-After`

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again in 30 seconds."
  }
}

503 · A service the API depends on is briefly unavailable; retry after the number of seconds in `Retry-After`

{
  "error": {
    "code": "unavailable",
    "message": "A service the API depends on is briefly unavailable. Try again in a few seconds."
  }
}