List shipments - PrimeFreight

curl "https://api.primefreight.com/v2/shipments?status=In%20Transit&limit=25" \
  -H "Authorization: Bearer <token>"

{
  "data": [
    {
      "id": "shp_100001",
      "file_number": "R00001",
      "status": "Departed Discharge Terminal",
      "customs_status": "Goods Not Yet Arrived",
      "delivery_status": "Goods Not Yet Arrived At Port",
      "eta_destination_revised": "2026-07-16T04:00:00-04:00",
      "container_id": "cnt_100001",
      "updated_at": "2026-07-16T05:12:44-04:00"
    },
    {
      "id": "shp_100002",
      "file_number": "R00002",
      "status": "Pre Alert",
      "customs_status": "Goods Not Yet Arrived",
      "delivery_status": "Goods Not Yet Arrived At Port",
      "eta_destination_revised": "2026-09-01T07:00:00-04:00",
      "container_id": "cnt_100002",
      "updated_at": "2026-07-14T09:03:11-04:00"
    }
  ],
  "next_cursor": "c_2b9f1a",
  "has_more": true
}

curl "https://api.primefreight.com/v2/shipments?status=In%20Transit&limit=25" \
  -H "Authorization: Bearer <token>"

GET /v2/shipments Returns a paginated list of shipment summaries, newest activity first. Use updated_since to poll for changes.

Query parameters

string

Filter by journey status. See Status values.

string

Only shipments changed at or after this ISO 8601 time. Use it to poll for updates.

integer

default:"25"

Page size, 1–100.

string

Pagination cursor from the previous page’s next_cursor.

Response

Each item in data is a shipment summary.

Field	Type	Description
`id`	string	Shipment ID
`file_number`	string	PrimeFreight file number
`status`	string	Journey status. See Status values
`customs_status`	string	Customs status
`delivery_status`	string	Delivery status
`eta_destination_revised`	string	Latest revised ETA at destination
`container_id`	string	ID of the container on this shipment
`updated_at`	string	When the shipment last changed

The envelope also returns next_cursor (string, or null on the last page) and has_more (boolean).

{
  "data": [
    {
      "id": "shp_100001",
      "file_number": "R00001",
      "status": "Departed Discharge Terminal",
      "customs_status": "Goods Not Yet Arrived",
      "delivery_status": "Goods Not Yet Arrived At Port",
      "eta_destination_revised": "2026-07-16T04:00:00-04:00",
      "container_id": "cnt_100001",
      "updated_at": "2026-07-16T05:12:44-04:00"
    },
    {
      "id": "shp_100002",
      "file_number": "R00002",
      "status": "Pre Alert",
      "customs_status": "Goods Not Yet Arrived",
      "delivery_status": "Goods Not Yet Arrived At Port",
      "eta_destination_revised": "2026-09-01T07:00:00-04:00",
      "container_id": "cnt_100002",
      "updated_at": "2026-07-14T09:03:11-04:00"
    }
  ],
  "next_cursor": "c_2b9f1a",
  "has_more": true
}

​Query parameters

​Response

Query parameters

Response