> ## Documentation Index > Fetch the complete documentation index at: https://developers.redo.com/llms.txt > Use this file to discover all available pages before exploring further. # List 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. ## OpenAPI ````yaml /api-schema/openapi.yaml get /stores/{storeId}/inbound-shipments openapi: 3.1.0 info: contact: email: engineering-admin@getredo.com name: Redo Engineering description: | ## Endpoints Endpoints are authenticated using the Bearer authorization scheme, using the REDO_API_SECRET. ```txt GET /v2.2/resource HTTP/1.1 Authorization: Bearer 77bb7598b7a972475cc7c7e171ec33af Host: api.getredo.com ``` ## Webhooks Webhooks are authenticated using the Bearer authorization scheme, using a secret supplied by the subscriber. ```txt POST /events HTTP/1.1 Authorization: Bearer subscriberauth123 Host: subscriber.example.com ``` Webhook events are delivered in order for each individual subject (e.g. return). If the response is not a 2xx status code, the event will be retried multiple times before discarding it. title: Redo API version: 2.2.1 servers: - url: https://api.getredo.com/v2.2 security: [] tags: - name: Checkout Buttons - name: Coverage Info - name: Coverage Products - name: Custom Events - name: Customer Portal - name: Customer Subscriptions - name: Customers - name: Inbound Shipments - name: Inventory Items - name: Inventory Levels - name: Invoices - name: Merchant Admin - name: Orders - name: Products - name: Returns - name: Storefront - name: Webhooks paths: /stores/{storeId}/inbound-shipments: summary: Inbound Shipments description: Inbound shipments for a store. parameters: - $ref: '#/components/parameters/store-id.param' get: tags: - Inbound Shipments summary: List Inbound Shipments description: >- 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. operationId: Inbound shipments list parameters: - $ref: '#/components/parameters/page-continue.param' - $ref: '#/components/parameters/page-size.param' - $ref: '#/components/parameters/inbound-shipment-status.param' - $ref: '#/components/parameters/location-id.param' - $ref: '#/components/parameters/created-at-min.param' - $ref: '#/components/parameters/created-at-max.param' responses: '200': content: application/json: schema: properties: inbound_shipments: items: $ref: '#/components/schemas/inbound-shipment-list.schema' type: array required: - inbound_shipments type: object description: Success headers: X-Page-Next: $ref: '#/components/headers/page-next.header' default: content: application/problem+json: schema: $ref: '#/components/schemas/error.schema' description: Error security: - Bearer: [] components: parameters: store-id.param: description: Store ID in: path name: storeId required: true schema: example: 64e5a8a1af49a89df37e4ee7 type: string page-continue.param: description: Page marker, from X-Page-Next header example: 64df700931a04885276c3364 in: header name: X-Page-Continue schema: type: string page-size.param: description: Page size, defaults to 20 example: 20 in: header name: X-Page-Size schema: maximum: 500 minimum: 1 type: integer inbound-shipment-status.param: description: Filter by shipment status example: IN_TRANSIT in: query name: status schema: enum: - PENDING - IN_TRANSIT - PARTIALLY_RECEIVED - RECEIVED type: string location-id.param: description: Filter by location ID (e.g. `loc_...`) example: loc_4d8e1a2b3c in: query name: location_id schema: type: string created-at-min.param: description: Minimum created time, inclusive example: '2000-01-01T00:00:00Z' in: query name: created_at_min schema: format: date-time type: string created-at-max.param: description: Maximum created time, exclusive example: '2026-01-01T00:00:00Z' in: query name: created_at_max schema: format: date-time type: string schemas: inbound-shipment-list.schema: description: Inbound shipment (list view). properties: id: description: Prefixed shipment ID (`inb_...`). example: inb_7a3f9c2e1b type: string shipment_id: description: Merchant-assigned shipment identifier. example: SHIP-2026-0042 nullable: true type: string status: description: Shipment status. enum: - PENDING - IN_TRANSIT - PARTIALLY_RECEIVED - RECEIVED example: IN_TRANSIT type: string location: $ref: '#/components/schemas/inbound-shipment-location.schema' carrier: description: Carrier name. example: FedEx Freight nullable: true type: string tracking_number: description: Tracking number. example: '794644790132' nullable: true type: string tracking_url: description: Tracking URL. example: https://www.fedex.com/fedextrack/?trknbr=794644790132 nullable: true type: string estimated_arrival_date: description: Expected arrival date (YYYY-MM-DD). example: '2026-04-15' format: date nullable: true type: string actual_arrival_date: description: Actual arrival date (YYYY-MM-DD). example: null format: date nullable: true type: string freight_type: description: Type of freight (e.g. `LTL`, `FTL`, `Parcel`). example: LTL nullable: true type: string payment_terms: description: Payment terms (e.g. `NET30`, `COD`). example: NET30 nullable: true type: string freight_cost: $ref: '#/components/schemas/inbound-shipment-money.schema' duty_cost: $ref: '#/components/schemas/inbound-shipment-money.schema' items: items: $ref: '#/components/schemas/inbound-shipment-item-list.schema' type: array sku_count: description: Distinct SKU count. example: 2 type: integer item_count: description: Total expected unit quantity. example: 800 type: integer received_count: description: Total received units. example: 0 type: integer created_at: description: Creation timestamp (ISO 8601). example: '2026-03-28T14:30:00Z' format: date-time type: string updated_at: description: Last updated timestamp (ISO 8601). example: '2026-03-29T09:15:00Z' format: date-time type: string required: - id - shipment_id - status - location - carrier - tracking_number - tracking_url - estimated_arrival_date - actual_arrival_date - freight_type - payment_terms - freight_cost - duty_cost - items - sku_count - item_count - received_count - created_at - updated_at title: Inbound Shipment type: object error.schema: description: >- Problem details. See [RFC 7807 Section 3](https://datatracker.ietf.org/doc/html/rfc7807#section-3). properties: detail: description: Human-readable description of the problem. title: Detail type: string instance: description: A URI reference that identifies this problem. format: uri-reference type: string title: description: Human-readable summary of the problem type. title: Title type: string type: default: about:blank description: A URI reference that identifies the problem type. format: uri-reference type: string title: Problem details type: object inbound-shipment-location.schema: description: Destination location. properties: id: description: Prefixed location ID (`loc_...`). example: loc_4d8e1a2b3c type: string name: description: Location name. example: East Coast Warehouse type: string required: - id - name title: Inbound Shipment Location type: object inbound-shipment-money.schema: description: Monetary amount with currency. properties: amount: description: Decimal amount as a string. example: '1250.00' type: string currency: description: ISO 4217 currency code. example: USD type: string required: - amount - currency title: Money type: object inbound-shipment-item-list.schema: description: Inbound shipment line item (list view). properties: id: description: Prefixed shipment item ID (`isp_...`). example: isp_8b2c3d4e5f type: string product: $ref: '#/components/schemas/inbound-shipment-product-summary.schema' quantity: description: Expected quantity. example: 500 type: integer received_quantity: description: Quantity received so far. example: 0 type: integer damaged_quantity: description: Damaged units. example: 0 type: integer missing_quantity: description: Missing units. example: 0 type: integer required: - id - product - quantity - received_quantity - damaged_quantity - missing_quantity title: Inbound Shipment Item type: object inbound-shipment-product-summary.schema: description: Product summary in a shipment item. properties: id: description: Prefixed product ID (`prd_...`). example: prd_1a2b3c4d5e type: string title: description: Product title including variant options. example: Classic Cotton T-Shirt - Black / M type: string sku: description: Stock keeping unit. example: TSH-BLK-M nullable: true type: string image_url: description: URL of the product's primary image. example: https://cdn.example.com/tshirt-blk-m.jpg nullable: true type: string required: - id - title - sku title: Inbound Shipment Product Summary type: object headers: page-next.header: description: Next value for X-Page-Continue, for more results schema: type: string securitySchemes: Bearer: scheme: bearer type: http ````