---
title: "Get All Shipments"
method: GET
path: "/freight/shipments"
tags: ["freight", "Shipments"]
---

# Get All Shipments

`GET /freight/shipments`

## Request

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

Returns all Shipments for the Freight connection associated with the provided access token.

## Query parameters

- `page_token` string, nullable
- `limit` integer
- `ids` FreightShipmentIdsQueryParam
  - `in` string[], required: A comma-separated list of resource IDs. If provided, all other query params are ignored.
- `created_date` FreightShipmentCreatedDateQueryParam
  - `eq` string, date-time
  - `neq` string, date-time
  - `in` string[]: Comma-separated.
  - `nin` string[]: Comma-separated.
  - `gt` string, date-time
  - `gte` string, date-time
  - `lt` string, date-time
  - `lte` string, date-time
- `updated_date` FreightShipmentUpdatedDateQueryParam
  - `eq` string, date-time
  - `neq` string, date-time
  - `in` string[]: Comma-separated.
  - `nin` string[]: Comma-separated.
  - `gt` string, date-time
  - `gte` string, date-time
  - `lt` string, date-time
  - `lte` string, date-time
- `trackstar_created_date` FreightShipmentTrackstarCreatedDateQueryParam
  - `eq` string, date-time
  - `neq` string, date-time
  - `in` string[]: Comma-separated.
  - `nin` string[]: Comma-separated.
  - `gt` string, date-time
  - `gte` string, date-time
  - `lt` string, date-time
  - `lte` string, date-time
- `trackstar_updated_date` FreightShipmentTrackstarUpdatedDateQueryParam
  - `eq` string, date-time
  - `neq` string, date-time
  - `in` string[]: Comma-separated.
  - `nin` string[]: Comma-separated.
  - `gt` string, date-time
  - `gte` string, date-time
  - `lt` string, date-time
  - `lte` string, date-time

## Headers

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

## Response `200`

Successful response

- FreightShipmentsListEndpoint
  - `data` FreightShipmentApiItemSchema[], required
    - `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
  - `next_token` string, nullable, required: See [pagination](/how-to-guides/about-the-api#pagination) for more details.
  - `total_count` integer, required: The number of items returned.

## Other responses

- `422`: Validation error

## Changes

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

[Operation history](https://skmtc.dev/trackstarhq/apis/trackstar-api/changes/freight/shipments/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)