ship

Get shipment

Look up one label by shipment_id with its tracking status, label and QR links, refund status and history, refreshed from the carrier. Free. When the carrier has confirmed a refund requested with void_label, this call credits the label price back to the balance, once.

get/v1/shipments/{shipment_id}

Request

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

Path parameters

shipment_idstring required

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.