Cancel a pending parcel quote
Cancel a parcel quote that has **not** been converted to a shipment. Only `pending` quotes can be cancelled.
Cancelling a quote is a soft action: the quote stays retrievable with `status` set to `cancelled` (see `cancelled_at`, `closed_reason`, and `comment`). Once cancelled it cannot be purchased (`create_shipment` will reject it).
Authentication
X-Api-Keystring
API Key authentication via header
Path parameters
id
Parcel quote token
Request
This endpoint expects an object.
comment
Optional free-text reason for the cancellation.
Response
OK — quote cancelled
parcel_quote_id
status
source
direction
reference
rates
sender
recipient
package
Air weight/dimensions, or ocean packages[] nested under package in responses.
cargo_volume
Human-readable cargo summary, e.g. 2 x 40' (ocean) or 5 kg (air).
origin_details
dest_details
parcel_details
tracking_code
label_url
selected_rate
tracker_id
purchased_at
Legacy booking timestamp when status is booked. Same moment as booked_at. Not payment confirmation for ocean/import intake quotes.
booked_at
When the quote became booked. Null while pending.
cancelled_at
When the quote was cancelled. Null while not cancelled.
closed_reason
Reason the quote was cancelled.
comment
Optional free-text note attached when the quote was cancelled.
estimated_price
NGN total from selected_rate.rate. For ocean/import intake, provisional until warehouse receive; customer payment is invoiced separately.
created_at
Errors
401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error