Skip to main content
Errors return JSON with an error string. 
{
  "error": "Order not found"
}

​
Status codes

StatusMeaning
400The request body, path parameter, or operation state is invalid.
403Authentication, authorization, ownership, or scope check failed.
404The route or resource was not found.
500An unexpected ArchiveOrder request failure occurred.

​
Client recommendations

  • Log the HTTP method, path, status code, and error value.
  • Avoid exposing raw error strings directly to end users.
  • Retry network failures and safe 5xx cases with the same Idempotency-Key for mutating requests.
  • Do not retry 400, 403, or 404 without changing the request or credentials.

​
Example

curl "$ARCHIVE_ORDER_BASE_URL/orders/missing_order" \
  -H "Authorization: Bearer $ARCHIVE_ORDER_API_KEY"

{
  "error": "Order not found"
}