Errors

Errors return an HTTP status code and, except as noted below, a JSON body:

{
  "code": "NOT_FOUND",
  "status": 404,
  "message": "Order not found."
}

Error	Meaning
`400 BAD_REQUEST`	The request can’t be processed.
`401 UNAUTHORIZED`	The API key is missing, invalid or revoked.
`404 NOT_FOUND`	The resource doesn’t exist.
`409 CONFLICT`	The `requestId` conflicts with an earlier request. See Idempotency.
`422 INPUT_VALIDATION_FAILED`	The body is invalid. `data.fieldErrors` lists problems with fields, and `data.formErrors` problems with the body as a whole.
`503 SERVICE_UNAVAILABLE`	A temporary outage. Retry with backoff.

A malformed JSON body returns 400 and a body over 1 MB returns 413, both as plain text. Retry 5xx errors with backoff and the same requestId. Retry a 409 for a request that’s still starting, unchanged, after a short delay. Fix the request before retrying any other 4xx error.

Get started

Concepts

API reference