---
title: "List all Manifests"
method: GET
path: "/2024-09/manifests"
tags: ["Manifests"]
---

# List all Manifests

`GET /2024-09/manifests`

Retrieve a list of [manifests](https://support.easyship.com/hc/en-us/articles/4414489808525-What-Is-a-Manifest-in-Shipping).

Required authorization scope: `public.manifest:read`

## Query parameters

- `page` integer
- `per_page` integer
- `courier_umbrella_name` string
- `courier_id` string
- `ref_number` string[]
- `created_at_from` string
- `created_at_to` string

## Response `200`

list of manifests

- ManifestList — List of manifests
  - `manifests` Manifest[]
    - `id` string, uuid — Manifest ID
    - `courier` object
      - `id` string, uuid — Courier ID
      - `umbrella_name` string — Human-readable name for the courier company that offers this service.
    - `created_at` string, date-time — Manifest creation date
    - `ref_number` string — Manifest reference number
    - `shipments_count` number — Number of shipments in manifest
    - `document` object — Manifest document
      - `format` 'url' — Manifest document format
      - `url` string — Manifest document URL
  - `meta` MetaWithPagination
    - `pagination` Pagination — Pagination
      - `next` integer, nullable
      - `count` integer, nullable — The total number of items. The `null` value is used with countless pagination (used for faster response on large datasets, like shipments).
      - `page` integer — Current page
    - `request_id` string — An unique ID represent the request.

---

[API](https://skmtc.net/easyship/apis/easyship-public-api.md) · [All operations](https://skmtc.net/easyship/apis/easyship-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/easyship/easyship-public-api/revisions/71d737a5fcbf/schema)