Errors

Always send Accept: application/json. Use HTTP status codes to identify errors, as message text can vary with server language.

Status	Meaning
401	Missing or invalid credentials.
403	Access, scope or catalog-price authorization denied.
404	Route or resource not found.
422	Validation failed. Correct the fields in errors.
429	Rate limit exceeded. Respect Retry-After.
500	Server error. Keep request context and avoid duplicate sales.

Example missing-scope response:

{
  "message": "API key does not have the required scope.",
  "required_scope": "sales.orders:write"
}

Not every error contains a field-level errors object.