---
title: "Retrieve shipment by id"
method: GET
path: "/api/v1/shipments/{id}"
tags: ["Shipments"]
---

# Retrieve shipment by id

`GET /api/v1/shipments/{id}`

Retrieve a shipment by id

Returns shipment information if the lookup succeeds.

## Path parameters

- `id` string, required

## Response `200`

Shipment information

- union
  - union — Shipments that have tracking information (shipped, delayed, or delivered states)
    - ShippedShipment
      - `updatedAt` string, date-time, required
      - `createdAt` string, date-time, required
      - `marketplaceOrderId` string, required
      - `checkoutIntentId` string, required
      - `id` string, required
      - `trackingEvents` TrackingEvent[], required
        - `status` 'out_for_delivery' | 'delivered' | 'shipped' | 'canceled' | 'delayed' | 'ordered', required
        - `location` EventLocation, required
          - `country` string, nullable
          - `province` string, nullable
          - `city` string, nullable
        - `timestamp` TrackingEventTimestamp, required
          - `local` string, required — ISO 8601 string with timezone offset, e.g. "2025-02-05T17:02:00.000-05:00"
          - `utc` string, date-time, required — UTC timestamp
        - `description` string, nullable, required
      - `shippedAt` string, date-time, required
      - `tracking` ShipmentTracking, required
        - `carrierName` string, nullable
        - `number` string, nullable, required
        - `deliveryDate` DeliveryDate
          - `estimated` string, date-time, required
        - `url` string, nullable
      - `externalId` string, required — The external ID is provided by the marketplace and matches the shipment to their system.
      - `status` 'shipped', required
    - DeliveredShipment
      - `updatedAt` string, date-time, required
      - `createdAt` string, date-time, required
      - `marketplaceOrderId` string, required
      - `checkoutIntentId` string, required
      - `id` string, required
      - `trackingEvents` TrackingEvent[], required
        - `status` 'out_for_delivery' | 'delivered' | 'shipped' | 'canceled' | 'delayed' | 'ordered', required
        - `location` EventLocation, required
          - `country` string, nullable
          - `province` string, nullable
          - `city` string, nullable
        - `timestamp` TrackingEventTimestamp, required
          - `local` string, required — ISO 8601 string with timezone offset, e.g. "2025-02-05T17:02:00.000-05:00"
          - `utc` string, date-time, required — UTC timestamp
        - `description` string, nullable, required
      - `shippedAt` string, date-time, required
      - `tracking` ShipmentTracking, required
        - `carrierName` string, nullable
        - `number` string, nullable, required
        - `deliveryDate` DeliveryDate
          - `estimated` string, date-time, required
        - `url` string, nullable
      - `externalId` string, required — The external ID is provided by the marketplace and matches the shipment to their system.
      - `status` 'delivered', required
      - `deliveredAt` string, date-time, required
    - DelayedShipment
      - `updatedAt` string, date-time, required
      - `createdAt` string, date-time, required
      - `marketplaceOrderId` string, required
      - `checkoutIntentId` string, required
      - `id` string, required
      - `trackingEvents` TrackingEvent[], required
        - `status` 'out_for_delivery' | 'delivered' | 'shipped' | 'canceled' | 'delayed' | 'ordered', required
        - `location` EventLocation, required
          - `country` string, nullable
          - `province` string, nullable
          - `city` string, nullable
        - `timestamp` TrackingEventTimestamp, required
          - `local` string, required — ISO 8601 string with timezone offset, e.g. "2025-02-05T17:02:00.000-05:00"
          - `utc` string, date-time, required — UTC timestamp
        - `description` string, nullable, required
      - `shippedAt` string, date-time, required
      - `tracking` ShipmentTracking, required
        - `carrierName` string, nullable
        - `number` string, nullable, required
        - `deliveryDate` DeliveryDate
          - `estimated` string, date-time, required
        - `url` string, nullable
      - `externalId` string, required — The external ID is provided by the marketplace and matches the shipment to their system.
      - `status` 'delayed', required
    - OutForDeliveryShipment
      - `updatedAt` string, date-time, required
      - `createdAt` string, date-time, required
      - `marketplaceOrderId` string, required
      - `checkoutIntentId` string, required
      - `id` string, required
      - `trackingEvents` TrackingEvent[], required
        - `status` 'out_for_delivery' | 'delivered' | 'shipped' | 'canceled' | 'delayed' | 'ordered', required
        - `location` EventLocation, required
          - `country` string, nullable
          - `province` string, nullable
          - `city` string, nullable
        - `timestamp` TrackingEventTimestamp, required
          - `local` string, required — ISO 8601 string with timezone offset, e.g. "2025-02-05T17:02:00.000-05:00"
          - `utc` string, date-time, required — UTC timestamp
        - `description` string, nullable, required
      - `shippedAt` string, date-time, required
      - `tracking` ShipmentTracking, required
        - `carrierName` string, nullable
        - `number` string, nullable, required
        - `deliveryDate` DeliveryDate
          - `estimated` string, date-time, required
        - `url` string, nullable
      - `externalId` string, required — The external ID is provided by the marketplace and matches the shipment to their system.
      - `status` 'out_for_delivery', required
  - union — Shipments without tracking information
    - OrderedShipment
      - `updatedAt` string, date-time, required
      - `createdAt` string, date-time, required
      - `marketplaceOrderId` string, required
      - `checkoutIntentId` string, required
      - `id` string, required
      - `status` 'ordered', required
    - CanceledShipment
      - `updatedAt` string, date-time, required
      - `createdAt` string, date-time, required
      - `marketplaceOrderId` string, required
      - `checkoutIntentId` string, required
      - `id` string, required
      - `status` 'canceled', required

## Other responses

- `401` — Authentication Failed
- `404` — Not Found

---

[API](https://skmtc.dev/rye-com/apis/universal-checkout-api.md) · [All operations](https://skmtc.dev/rye-com/apis/universal-checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rye-com/universal-checkout-api/revisions/175c7f9e090e/schema)