---
title: "List Inbound Shipments"
method: GET
path: "/stores/{storeId}/inbound-shipments"
tags: ["Inbound Shipments"]
---

# List Inbound Shipments

`GET /stores/{storeId}/inbound-shipments`

List inbound shipments, representing inventory in transit or received at a location. Sorted by most recently updated first.
Requires the [`inbound_shipments_read`](/docs/api-reference/scopes) scope.

## Query parameters

- `status` 'PENDING' | 'IN_TRANSIT' | 'PARTIALLY_RECEIVED' | 'RECEIVED'
- `location_id` string
- `created_at_min` string, date-time
- `created_at_max` string, date-time

## Headers

- `X-Page-Continue` string
- `X-Page-Size` integer

## Response `200`

Success

- object
  - `inbound_shipments` InboundShipmentListSchema[], required
    - `id` string, required — Prefixed shipment ID (`inb_...`).
    - `shipment_id` string, nullable, required — Merchant-assigned shipment identifier.
    - `status` 'PENDING' | 'IN_TRANSIT' | 'PARTIALLY_RECEIVED' | 'RECEIVED', required — Shipment status.
    - `location` InboundShipmentLocationSchema, required — Destination location.
      - `id` string, required — Prefixed location ID (`loc_...`).
      - `name` string, required — Location name.
    - `carrier` string, nullable, required — Carrier name.
    - `tracking_number` string, nullable, required — Tracking number.
    - `tracking_url` string, nullable, required — Tracking URL.
    - `estimated_arrival_date` string, date, nullable, required — Expected arrival date (YYYY-MM-DD).
    - `actual_arrival_date` string, date, nullable, required — Actual arrival date (YYYY-MM-DD).
    - `freight_type` string, nullable, required — Type of freight (e.g. `LTL`, `FTL`, `Parcel`).
    - `payment_terms` string, nullable, required — Payment terms (e.g. `NET30`, `COD`).
    - `freight_cost` InboundShipmentMoneySchema, required — Monetary amount with currency.
      - `amount` string, required — Decimal amount as a string.
      - `currency` string, required — ISO 4217 currency code.
    - `duty_cost` InboundShipmentMoneySchema, required — Monetary amount with currency.
      - `amount` string, required — Decimal amount as a string.
      - `currency` string, required — ISO 4217 currency code.
    - `items` InboundShipmentItemListSchema[], required
      - `id` string, required — Prefixed shipment item ID (`isp_...`).
      - `product` InboundShipmentProductSummarySchema, required — Product summary in a shipment item.
        - `id` string, required — Prefixed product ID (`prd_...`).
        - `title` string, required — Product title including variant options.
        - `sku` string, nullable, required — Stock keeping unit.
        - `image_url` string, nullable — URL of the product's primary image.
      - `quantity` integer, required — Expected quantity.
      - `received_quantity` integer, required — Quantity received so far.
      - `damaged_quantity` integer, required — Damaged units.
      - `missing_quantity` integer, required — Missing units.
    - `sku_count` integer, required — Distinct SKU count.
    - `item_count` integer, required — Total expected unit quantity.
    - `received_count` integer, required — Total received units.
    - `created_at` string, date-time, required — Creation timestamp (ISO 8601).
    - `updated_at` string, date-time, required — Last updated timestamp (ISO 8601).

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/redoapp/apis/redo-api.md) · [All operations](https://skmtc.dev/redoapp/apis/redo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/redoapp/redo-api/revisions/119714540a45/schema)