Skip to main content

Error Handling & Retries

Shipdesk returns standard HTTP response codes alongside the unified Shipdesk error envelope.

Error Envelope Reference


HTTP Status Codes


Retrying Transient Failures

  • Safe to retry (Idempotent): All GET requests, POST /v1/rates, POST /v1/serviceability.
  • Never blindly retry: POST /v1/orders/:id/assign. Writes to couriers can create duplicate AWBs if retried blindly. If an assignment call times out, call GET /v1/orders/:id first to inspect if an AWB was already claimed before attempting reassignment.