List container events - PrimeFreight

curl https://api.primefreight.com/v2/containers/cnt_100001/events \
  -H "Authorization: Bearer <token>"

{
  "container_id": "cnt_100001",
  "container_number": "ABCU1234567",
  "data": [
    { "status": "Pre Alert",                   "timestamp": "2026-06-16T04:56:56-04:00", "source": "primefreight" },
    { "status": "In Transit",                  "timestamp": "2026-06-19T07:10:45-04:00", "source": "primefreight" },
    { "status": "Arrived Not Yet Discharged",  "timestamp": "2026-07-08T11:37:45-04:00", "source": "primefreight" },
    { "status": "Departed Discharge Terminal", "timestamp": "2026-07-09T05:39:36-04:00", "source": "primefreight" }
  ]
}

curl https://api.primefreight.com/v2/containers/cnt_100001/events \
  -H "Authorization: Bearer <token>"

GET /v2/containers/{id}/events Returns the container’s status timeline — one event for each change to its journey status, in chronological order.

Each event is a single change of journey status. Other changes (ETA revisions, corrections) are not returned as events. Status values are the ocean ladder listed under Status values.

Path parameters

string

required

The container ID.

Response

container_id and container_number identify the box; data is the ordered list of status changes.

Field	Type	Description
`container_id`	string	Container ID
`container_number`	string	Container number
`data[].status`	string	The journey status the container moved into
`data[].timestamp`	string	When the change was recorded
`data[].source`	string	Always `primefreight`

{
  "container_id": "cnt_100001",
  "container_number": "ABCU1234567",
  "data": [
    { "status": "Pre Alert",                   "timestamp": "2026-06-16T04:56:56-04:00", "source": "primefreight" },
    { "status": "In Transit",                  "timestamp": "2026-06-19T07:10:45-04:00", "source": "primefreight" },
    { "status": "Arrived Not Yet Discharged",  "timestamp": "2026-07-08T11:37:45-04:00", "source": "primefreight" },
    { "status": "Departed Discharge Terminal", "timestamp": "2026-07-09T05:39:36-04:00", "source": "primefreight" }
  ]
}

This is a status-level timeline — expect milestones like “In Transit” or “Departed Discharge Terminal”, not per-scan carrier events such as individual rail interchanges or vessel berthing.

​Path parameters

​Response

Path parameters

Response