---
title: "List shipments for the authenticated customer"
method: GET
path: "/customer-order-shipments"
tags: ["Customer Order"]
---

# List shipments for the authenticated customer

`GET /customer-order-shipments`

## Request

- Base URL: `http://localhost:8000/api/shop`
- URL: `http://localhost:8000/api/shop/customer-order-shipments`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bagisto/apis/bagisto-shop-api/docs/customer-order-shipments/get.ts> (a function with typed inputs; its response is checked against the schema)

Mirrors the GraphQL `customerOrderShipments(orderId:)` query. Use `?order_id=N` to scope to a specific order, `?status=X` to filter by shipment status.

## Query parameters

- `order_id` integer
- `status` string
- `page` integer
- `per_page` integer

## Headers

- `X-STOREFRONT-KEY` string, required
- `X-Locale` string
- `X-Channel` string
- `X-Currency` string

## Response `200`

CustomerOrderShipment collection

- CustomerOrderShipment[]
  - `id` integer
  - `status` string, nullable
  - `totalQty` integer, nullable
  - `totalWeight` number, nullable
  - `carrierCode` string, nullable
  - `carrierTitle` string, nullable
  - `trackNumber` string, nullable
  - `emailSent` boolean
  - `customerId` integer, nullable
  - `customerType` string, nullable
  - `inventorySourceId` integer, nullable
  - `inventorySourceName` string, nullable
  - `createdAt` string, date-time, nullable
  - `updatedAt` string, date-time, nullable
  - `shippingNumber` string
  - `items` string[]
  - `shippingAddress` string, iri-reference
  - `billingAddress` string, iri-reference

---

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