Errors

StatusMeaningRecovery
400Malformed request or missing rate_idCheck JSON shape, field types, and required ids.
401Missing or invalid API keySend a valid X-Api-Key; verify environment.
403Forbidden (CANCELLATION_NOT_ALLOWED)Cancellation is Send-operated. Contact support.
404Not found (RECORD_NOT_FOUND)Unknown quote, parcel, or customer id.
409Idempotency conflict (IDEMPOTENCY_CONFLICT)The key was reused with different content. Use a fresh key.
422Validation or business rule failureRead errors and code:
CodeCauseRecovery
VALIDATION_ERRORUnsupported lane, mode, commodity, measurements, or forbidden fieldsFix the named fields; see Transport Modes and Cargo.
EXPORT_NOT_SUPPORTEDExport direction requestedOnly import is supported.
RATE_NOT_CONFIGUREDLane/mode has no pricing configuredPick a supported lane and mode.
RATE_NOT_FOUNDrate_id not on the quoteGET the quote and use a current rate id.
QUOTE_RATE_OUTDATEDRate older than one hourGET the quote to refresh, then retry with the new id.
INVALID_PARTYSender/recipient missing, unknown, or incompleteSender requires a resolving customer_id. Recipient needs manual name/phone/address, or customer_as_recipient: true.
INVALID_STATUSQuote not pendingOnly pending quotes can be booked.
QUOTE_CANCELLEDQuote was cancelledCancelled quotes never convert; start a new quote.

Error bodies carry an errors array and, where applicable, a stable code.