---
title: "Get a shipment"
method: GET
path: "/shipments/{shipment_id}"
tags: ["Shipments"]
---

# Get a shipment

`GET /shipments/{shipment_id}`

## Request

- Base URL: `https://api.whatnot.com/seller-api/rest/v2`
- URL: `https://api.whatnot.com/seller-api/rest/v2/shipments/{shipment_id}`
- Auth: OAuth 2
  - Authorization code: `https://api.whatnot.com/seller-api/rest/oauth/authorize`
  - Token URL: `https://api.whatnot.com/seller-api/rest/oauth/token`

Retrieve a shipment owned by the authenticated seller. Requires read:shipments.

## Path parameters

- `shipment_id` string, required

## Response `200`

Successful Response

- Shipment
  - `id` string, required: The shipment's ID.
  - `url` string, required: The url of the shipment in the seller's dashboard.
  - `status` 'created' | 'label_generated' | 'dropped_off' | 'in_transit' | 'delivered' | 'failed' | 'cancelled' | 'cancelled_not_shipped' | 'cancelled_not_shipped_with_dropoff' | 'cancelled_tracking_stuck', required
  - `fulfillment_method` 'shipping' | 'pickup', required
  - `recipient` UserSummary, required
    - `id` string, required: The user's decimal ID.
    - `username` string, required: The user's username.
    - `display_name` string, nullable, required: The user's display name.
  - `weight` Weight, required
    - `value` number, required: The weight amount.
    - `unit` 'ounce' | 'pound' | 'gram' | 'kilogram', required: The unit used to express weight.
  - `dimensions` Dimensions, required
    - `length` number, required: The package length.
    - `width` number, required: The package width.
    - `height` number, required: The package height.
    - `unit` 'inch' | 'feet' | 'centimeter' | 'meter', required
  - `signature_required` boolean, required: Whether delivery requires a signature.
  - `hazardous_material` 'not_hazardous' | 'standard' | 'lithium_battery', required
  - `tracking` ShipmentTracking, required
    - `carrier` string, nullable, required: The carrier delivering this shipment.
    - `service` string, nullable, required: The carrier service used for this shipment.
    - `tracking_code` string, nullable, required: The carrier's tracking code for this shipment.
    - `last_mile_tracking_code` string, nullable, required: The tracking code used for the final leg of delivery.
  - `insurance` ShipmentInsurance, required
    - `amount` Money, required
      - `amount` string, required: Decimal amount in major currency units, e.g. 42.00.
      - `currency` string, required: ISO 4217 currency code.
    - `contents` string, nullable, required: Description of insured contents.
  - `seller_paid_shipping_cost` Money, required
    - `amount` string, required: Decimal amount in major currency units, e.g. 42.00.
    - `currency` string, required: ISO 4217 currency code.
  - `required_actions` ShipmentRequiredAction[], required: Actions required before fulfillment.
  - `dropoff_due` string, date-time, nullable, required: Due date at seller-local midnight, serialized with timezone; not the overdue cutoff. Null for pickup, non-pre-transit shipments, or missing inputs.
  - `replacement_shipment_id` string, nullable, required: Immediate successor shipment ID after replacement, bundling, or splitting; not the final successor in a chain.
  - `created_at` string, date-time, nullable, required: Creation timestamp, if recorded.
  - `updated_at` string, date-time, nullable, required: Last update timestamp, if recorded.

## Other responses

- `404`: Shipment not found.
- `422`: Validation Error

## Changes

- **2026-11-03** `e619f15f7ce0`: 1 info
  - added the required property `seller_paid_shipping_cost` to the response with the `200` status

[Operation history](https://skmtc.dev/whatnot/apis/whatnot-seller-api/changes/shipments/:shipment_id/get.md)

---

[API](https://skmtc.dev/whatnot/apis/whatnot-seller-api.md) - [All operations](https://skmtc.dev/whatnot/apis/whatnot-seller-api/llms.txt) - [OpenAPI document](https://skmtc.dev/whatnot/apis/whatnot-seller-api/revisions/e619f15f7ce0?raw)