ship

Void a label

Ask the carrier to refund a label that has not been used (nothing scanned yet), with confirm true; CONSEQUENTIAL and irreversible -- the label stops being valid -- and the credits come back only when the carrier confirms the refund, which for USPS takes about 15 days or more. Free. Sensitive write: it requires the human's approval to void that label.

post/v1/shipments/{shipment_id}/void

Request

  • Base URL: https://api.noerrands.com/c/ship
  • URL: https://api.noerrands.com/c/ship/v1/shipments/{shipment_id}/void
  • Auth: HTTP bearer

Path parameters

shipment_idstring required

Request body

shipment_idstring required
confirmtrue required

Must be true. Set it only after the human approved this exact action and price.

Response

Success.

shipment_idstring required

Opaque id, "sh_...". Use it with get_shipment.

kind'outbound' | 'return' required
status'unknown' | 'pre_transit' | 'in_transit' | 'out_for_delivery' | 'delivered' | 'available_for_pickup' | 'return_to_sender' | 'failure' | 'cancelled' | 'error' required

The carrier's tracking status. pre_transit means the label exists and nothing has been scanned yet.

carrierstring required
servicestring required
tracking_codestring required
label_urlstring uri

The printable PDF label. Gone after the retention window.

qr_code_urlstring uri

USPS QR code image. The human shows it at a post office counter and the clerk prints the label.

tracking_urlstring uri

The carrier's public tracking page.

est_delivery_datestring
credits_charged_centsinteger required

Net credits this label cost: zero once a refund has been confirmed.

refund_status'none' | 'submitted' | 'refunded' | 'rejected' required

none, or after void_label: submitted (waiting on the carrier), refunded (credits are back), rejected (the label was used or too old).

created_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.