Retrieve shipment
Retrieves the details of an existing shipment.
Required permissions:
shipment:basic:readpayment:basic:read
Authorizations
An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.
Path Parameters
The unique identifier of the shipment to retrieve.
"ship_xxxxxxxxxxxxx"
Response
A successful response
A physical shipment associated with a payment, including carrier details and tracking information.
The datetime the shipment was created.
"2023-12-01T05:00:00.401Z"
The estimated delivery date for this shipment. Null if the carrier has not provided an estimate.
"2023-12-01T05:00:00.401Z"
The unique identifier for the shipment.
"ship_xxxxxxxxxxxxx"
The payment associated with this shipment. Null if the payment has been deleted or is inaccessible.
The shipping service level used for this shipment. Null if the carrier does not specify a service tier.
"Priority"
The current delivery status of this shipment.
unknown, pre_transit, in_transit, out_for_delivery, delivered, available_for_pickup, return_to_sender, failure, cancelled, error A more granular status providing additional detail about the shipment's current state. Null if no substatus applies.
address_correction, arrived_at_destination, arrived_at_facility, arrived_at_pickup_location, awaiting_information, substatus_cancelled, damaged, delayed, delivery_exception, departed_facility, departed_origin_facility, expired, substatus_failure, held, substatus_in_transit, label_created, lost, missorted, substatus_out_for_delivery, received_at_destination_facility, received_at_origin_facility, refused, return, status_update, transferred_to_destination_carrier, transit_exception, substatus_unknown, weather_delay The carrier-assigned tracking number used to look up shipment progress.
"9400111899223456789012"
The datetime the shipment was last updated.
"2023-12-01T05:00:00.401Z"

