> ## Documentation Index
> Fetch the complete documentation index at: https://docs.primefreight.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List container events

> Retrieve a container's status timeline.

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.primefreight.com/v2/containers/cnt_100001/events \
    -H "Authorization: Bearer <token>"
  ```
</RequestExample>

`GET /v2/containers/{id}/events`

Returns the container's status timeline — one event for each change to its journey status, in chronological order.

<Note>
  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](/api-reference/v2/status-values).
</Note>

## Path parameters

<ParamField path="id" type="string" required>
  The container ID.
</ParamField>

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

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "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" }
    ]
  }
  ```
</ResponseExample>

<Warning>
  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.
</Warning>