---
title: "Get EasyPost shipments"
method: GET
path: "/api/v3/easypost/shipments"
tags: ["easypost"]
---

# Get EasyPost shipments

`GET /api/v3/easypost/shipments`

## Request

- Base URL: `https://api.endless.health` (the document declares no server; this is the origin it was published from)
- URL: `https://api.endless.health/api/v3/easypost/shipments`
- Auth: API key in header `X-API-KEY`

Retrieve a list of shipments from EasyPost API with pagination support

## Query parameters

- `page_size` integer: Number of shipments to retrieve (1-100)

## Response `200`

Successful Response

- EasyPostShipmentsDetailedResponseSchema: Schema for detailed shipments response with pagination
  - `shipments` EasyPostShipmentDetailSchema[], required
    - `id` string, required
    - `tracking_code` string, nullable
    - `status` string, nullable
    - `created_at` string, nullable
    - `updated_at` string, nullable
    - `mode` string, nullable
    - `reference` string, nullable
    - `batch_id` string, nullable
    - `batch_status` string, nullable
    - `carrier` string, nullable
    - `service` string, nullable
    - `rate` string, nullable
    - `currency` string, nullable
    - `delivery_days` integer, nullable
    - `est_delivery_date` string, nullable
    - `from_address` object, nullable
    - `to_address` object, nullable
    - `parcel` object, nullable
    - `postage_label` object, nullable
    - `tracker` object, nullable
    - `rates` object[], nullable
    - `selected_rate` object, nullable
    - `fees` object[], nullable
    - `customs_info` object, nullable
    - `scan_form` object, nullable
    - `forms` object[], nullable
    - `messages` object[], nullable
    - `options` object, nullable
    - `insurance` object, nullable
    - `order_id` string, nullable
    - `refund_status` string, nullable
    - `return_address` object, nullable
    - `buyer_address` object, nullable
    - `usps_zone` integer, nullable
    - `is_return` boolean, nullable
    - `object` string, nullable
  - `has_more` boolean, nullable

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/endless/apis/eh-core-v3-api-prod.md) - [All operations](https://skmtc.dev/endless/apis/eh-core-v3-api-prod/llms.txt) - [OpenAPI document](https://skmtc.dev/endless/apis/eh-core-v3-api-prod/revisions/9046a1eb2d0c?raw)