---
title: "Get EasyPost shipment by ID"
method: GET
path: "/api/v3/easypost/shipments/{shipment_id}"
tags: ["easypost"]
---

# Get EasyPost shipment by ID

`GET /api/v3/easypost/shipments/{shipment_id}`

## 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/{shipment_id}`
- Auth: API key in header `X-API-KEY`

Retrieve a specific shipment by its ID from EasyPost API

## Path parameters

- `shipment_id` string, required: The EasyPost shipment ID

## Response `200`

Successful Response

- EasyPostShipmentDetailSchema: Schema for individual shipment details
  - `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

## 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)