---
title: "Get Shipment"
method: GET
path: "/freight/shipments/{shipment_id}"
tags: ["freight", "Shipments"]
---

# Get Shipment

`GET /freight/shipments/{shipment_id}`

## Request

- Base URL: `https://production.trackstarhq.com`
- URL: `https://production.trackstarhq.com/freight/shipments/{shipment_id}`
- Auth: none required

Returns a single Shipment for the Freight connection with the associated shipment id.

## Path parameters

- `shipment_id` string, required

## Headers

- `x-trackstar-api-key` string, required
- `x-trackstar-access-token` string, required

## Response `200`

Successful response

- FreightShipmentsSingleItemEndpoint
  - `data` FreightShipmentApiItemSchema
    - `id` string, required: The unique ID of the shipment.
    - `eta_date` string, date-time, nullable, required: The estimated arrival date of the shipment.
    - `created_date` string, date-time, required: The date the freight shipment was created.
    - `updated_date` string, date-time, required: The date the freight shipment was last updated.
    - `cost` number, nullable, required: The cost of the shipment.
    - `shipment_date` string, date-time, nullable, required: The date the shipment was sent from its origin.
    - `arrival_date` string, date-time, nullable, required: The actual date the shipment arrived at its destination.
    - `raw_status` string, nullable, required: The raw status of the shipment from the freight forwarder.
    - `status` 'pre_transit' | 'in_transit' | 'arrival_port' | 'en_route_to_destination' | 'final_destination', required: The status of the freight shipment. See the [freight shipment information](info) for more details.
    - `shipment_method` string, required: The mode by which the shipment was transported (e.g. air, ocean)
    - `external_system_url` string, nullable, required: URL link to the freight shipment in the external system (WMS/Freight etc).
    - `additional_fields` object, required: Integration-specific fields
    - `trackstar_created_date` string, date-time, required
    - `trackstar_updated_date` string, date-time, required

## Other responses

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

## Changes

- **2026-11-03** `f9f948f2a7b3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trackstarhq/apis/trackstar-api/changes/freight/shipments/:shipment_id/get.md)

---

[API](https://skmtc.dev/trackstarhq/apis/trackstar-api.md) - [All operations](https://skmtc.dev/trackstarhq/apis/trackstar-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trackstarhq/apis/trackstar-api/revisions/08647f790594?raw)