---
title: "Get a list of shipments"
method: GET
path: "/shipments"
tags: ["Shipments"]
---

# Get a list of shipments

`GET /shipments`

Retrieves a paginated list of shipments with optional filtering by type and status

## Query parameters

- `page` integer
- `pageSize` integer
- `type` string
- `status` string

## Response `200`

OK

- ShipmentListResponse
  - `shipments` ShipmentSummaryDto[], nullable
    - `guid` string, nullable
    - `type` string, nullable
    - `number` string, nullable
    - `shipperName` string, nullable
    - `consigneeName` string, nullable
    - `status` 0 | 1 | 2 | 3 | 4 | 5
    - `direction` 0 | 1
    - `originPortCode` string, nullable
    - `destinationPortCode` string, nullable
    - `estimatedArrivalDate` string, nullable
    - `actualArrivalDate` string, nullable
    - `totalPieces` integer, nullable
    - `totalWeight` WeightValueDto
      - `value` number, double
      - `unit` 0 | 1 | 2 | 3 | 4 | 5
    - `totalValue` MoneyValueDto
      - `value` number, double
      - `currency` string, nullable
  - `totalCount` integer
  - `page` integer
  - `pageSize` integer
  - `totalPages` integer

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/magayacloud/apis/msc-api-proof-of-concept.md) · [All operations](https://skmtc.net/magayacloud/apis/msc-api-proof-of-concept/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/magayacloud/msc-api-proof-of-concept/revisions/9dbc3818a965/schema)