Skip to main content
GET
/
shipments
/
{id}
JavaScript
import Whop from '@whop/sdk';

const client = new Whop({
  apiKey: process.env['WHOP_API_KEY'], // This is the default and can be omitted
});

const shipment = await client.shipments.retrieve('ship_xxxxxxxxxxxxx');

console.log(shipment.id);
{
  "id": "ship_xxxxxxxxxxxxx",
  "created_at": "2023-12-01T05:00:00.401Z",
  "status": "unknown",
  "substatus": "address_correction",
  "tracking_code": "9400111899223456789012",
  "updated_at": "2023-12-01T05:00:00.401Z",
  "carrier": "accurate",
  "service": "Priority",
  "delivery_estimate": "2023-12-01T05:00:00.401Z",
  "payment": {
    "id": "pay_xxxxxxxxxxxxxx"
  }
}

Authorizations

​
Authorization
string
header
required

A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************

Path Parameters

​
id
string
required

The unique identifier of the shipment to retrieve.

Example:

"ship_xxxxxxxxxxxxx"

Response

A successful response

A physical shipment associated with a payment, including carrier details and tracking information.

​
id
string
required

The unique identifier for the shipment.

Example:

"ship_xxxxxxxxxxxxx"

​
created_at
string<date-time>
required

The datetime the shipment was created.

Example:

"2023-12-01T05:00:00.401Z"

​
status
enum<string>
required

The current delivery status of this shipment.

Available options:
unknown,
pre_transit,
in_transit,
out_for_delivery,
delivered,
available_for_pickup,
return_to_sender,
failure,
cancelled,
error
​
substatus
enum<string> | null
required

A more granular status providing additional detail about the shipment's current state. Null if no substatus applies.

Available options:
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
​
tracking_code
string
required

The carrier-assigned tracking number used to look up shipment progress.

Example:

"9400111899223456789012"

​
updated_at
string<date-time>
required

The datetime the shipment was last updated.

Example:

"2023-12-01T05:00:00.401Z"

​
carrier
enum<string>
required

The shipping carrier responsible for delivering this shipment.

Available options:
accurate,
amazon_mws,
amazon_shipping,
apc,
asendia_usa,
australia_post,
axlehire_v3,
better_trucks,
canada_post,
canpar,
columbus_last_mile,
chronopost,
cloud_sort,
courier_express,
couriers_please,
cs_logistics,
dai_post,
deutsche_post_uk,
deutsche_post,
dhl_ecommerce_asia,
dhl_ecs,
dhl_express,
dhl_paket,
door_dash,
dpd_nl,
dpd_uk,
dpd,
epost_global,
estafeta,
evri,
fastway,
fedex_cross_border,
fedex_default,
fedex_mailview,
fedex_smartpost,
fedex,
first_choice,
first_mile,
flexport,
gio,
gio_express,
gso,
hailify,
henry,
interlink_express,
jet,
kuroneko_yamato,
la_post,
lasership_v2,
loomis_express,
lso,
ontrac,
optima,
osm_worldwide,
parcelforce,
parcll,
passport_global,
post_nl,
purolator,
quick,
royal_mail,
omni_parcel,
sendle,
sf_express,
smart_kargo,
sonic,
spee_dee,
swyft,
tforce,
uds,
ups_iparcel,
ups_mail_innovations,
ups,
usps,
veho,
yanwen
​
service
string | null
required

The shipping service level used for this shipment. Null if the carrier does not specify a service tier.

Example:

"Priority"

​
delivery_estimate
string<date-time> | null
required

The estimated delivery date for this shipment. Null if the carrier has not provided an estimate.

Example:

"2023-12-01T05:00:00.401Z"

​
payment
object
required

The payment associated with this shipment. Null if the payment has been deleted or is inaccessible.