> ## 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. # Get container transport events > Retrieve transport event data for a specific container # Get container transport events Retrieves the transport event data for a container by its ID. Transport events provide processed and normalized event data with standardized event types across all carriers. ## Endpoint Overview **GET** `/containers/{id}/transport_events` This endpoint returns processed transport events with normalized event types, status information, and location tracking data. ## Request Format ### Headers | Header | Type | Required | Description | | ----------- | ------ | -------- | ------------------------------- | | `X-API-Key` | string | Yes | Your API key for authentication | ### Path Parameters | Parameter | Type | Required | Description | | --------- | ------ | -------- | -------------------------------------- | | `id` | string | Yes | The unique identifier of the container | ## Response Format ### Success Response (200 OK) ```json theme={null} { "data": [ { "id": "efc3f3c1-cdc2-4a7d-a176-762ddec107b8", "type": "transport_event", "attributes": { "event": "container.transport.vessel_loaded", "created_at": "2021-01-05T08:41:12Z", "voyage_number": "15W10", "timestamp": null, "location_locode": "CLSAI", "timezone": "America/Santiago" }, "relationships": { "shipment": { "data": { "id": "06264731-503e-498e-bc76-f90b87b31562", "type": "shipment" } }, "container": { "data": { "id": "eeafd337-72b5-4e5c-87cb-9ef83fa99cf4", "type": "container" } }, "vessel": { "data": { "id": "345c05ab-4217-4ffe-a1a4-6c03b9ad2b36", "type": "vessel" } }, "location": { "data": { "id": "0ad2cf2b-e694-4ccc-9cd2-40af0d1fa1b5", "type": "port" } }, "terminal": { "data": null } } }, { "id": "951058bd-2c3b-4bcc-94e1-9be2526b9687", "type": "transport_event", "attributes": { "event": "container.transport.vessel_departed", "created_at": "2021-01-05T08:41:11Z", "voyage_number": "15W10", "timestamp": null, "location_locode": "CLSAI", "timezone": "America/Santiago" }, "relationships": { "shipment": { "data": { "id": "06264731-503e-498e-bc76-f90b87b31562", "type": "shipment" } }, "container": { "data": { "id": "eeafd337-72b5-4e5c-87cb-9ef83fa99cf4", "type": "container" } }, "vessel": { "data": { "id": "345c05ab-4217-4ffe-a1a4-6c03b9ad2b36", "type": "vessel" } }, "location": { "data": { "id": "0ad2cf2b-e694-4ccc-9cd2-40af0d1fa1b5", "type": "port" } }, "terminal": { "data": null } } }, { "id": "69af6795-56c2-4157-9a87-afd761cc85a0", "type": "transport_event", "attributes": { "event": "container.transport.full_out", "created_at": "2020-05-14T00:05:41Z", "voyage_number": null, "timestamp": "2020-04-14T00:00:00Z", "location_locode": "USOAK", "timezone": "America/Los_Angeles" }, "relationships": { "shipment": { "data": { "id": "06264731-503e-498e-bc76-f90b87b31562", "type": "shipment" } }, "container": { "data": { "id": "eeafd337-72b5-4e5c-87cb-9ef83fa99cf4", "type": "container" } }, "vessel": { "data": null }, "location": { "data": { "id": "42d1ba3a-f4b8-431d-a6fe-49fd748a59e7", "type": "port" } }, "terminal": { "data": null } } }, { "id": "68c3c29a-504a-4dbb-ad27-7194ef42d484", "type": "transport_event", "attributes": { "event": "container.transport.vessel_discharged", "created_at": "2020-05-14T00:05:41Z", "voyage_number": "15W10", "timestamp": "2020-04-13T00:00:00Z", "location_locode": "USOAK", "timezone": "America/Los_Angeles" }, "relationships": { "shipment": { "data": { "id": "06264731-503e-498e-bc76-f90b87b31562", "type": "shipment" } }, "container": { "data": { "id": "eeafd337-72b5-4e5c-87cb-9ef83fa99cf4", "type": "container" } }, "vessel": { "data": { "id": "345c05ab-4217-4ffe-a1a4-6c03b9ad2b36", "type": "vessel" } }, "location": { "data": { "id": "42d1ba3a-f4b8-431d-a6fe-49fd748a59e7", "type": "port" } }, "terminal": { "data": { "id": "3e550f0e-ac2a-48fb-b242-5be45ecf2c78", "type": "terminal" } } } }, { "id": "03349405-a9be-4f3e-abde-28f2cb3922bd", "type": "transport_event", "attributes": { "event": "container.transport.vessel_arrived", "created_at": "2020-05-14T00:05:41Z", "voyage_number": "15W10", "timestamp": "2020-04-13T01:24:00Z", "location_locode": "USOAK", "timezone": "America/Los_Angeles" }, "relationships": { "shipment": { "data": { "id": "06264731-503e-498e-bc76-f90b87b31562", "type": "shipment" } }, "container": { "data": { "id": "eeafd337-72b5-4e5c-87cb-9ef83fa99cf4", "type": "container" } }, "vessel": { "data": { "id": "345c05ab-4217-4ffe-a1a4-6c03b9ad2b36", "type": "vessel" } }, "location": { "data": { "id": "42d1ba3a-f4b8-431d-a6fe-49fd748a59e7", "type": "port" } }, "terminal": { "data": { "id": "3e550f0e-ac2a-48fb-b242-5be45ecf2c78", "type": "terminal" } } } }, { "id": "ba9f85b4-658d-4f23-9308-635964df8037", "type": "transport_event", "attributes": { "event": "container.transport.empty_in", "created_at": "2020-05-14T00:05:42Z", "voyage_number": null, "timestamp": "2020-04-15T00:00:00Z", "location_locode": null, "timezone": null }, "relationships": { "shipment": { "data": { "id": "06264731-503e-498e-bc76-f90b87b31562", "type": "shipment" } }, "container": { "data": { "id": "eeafd337-72b5-4e5c-87cb-9ef83fa99cf4", "type": "container" } }, "vessel": { "data": null }, "location": { "data": null }, "terminal": { "data": null } } } ] } ``` ### Response Fields | Field | Type | Description | | ------------------------------------- | ----------- | ------------------------------------------------------------ | | `data[].id` | string | Transport event ID | | `data[].type` | string | Always `transport_event` | | `data[].attributes.event` | string | Normalized event (e.g., `container.transport.vessel_loaded`) | | `data[].attributes.created_at` | string | Record creation timestamp (ISO 8601) | | `data[].attributes.voyage_number` | string/null | Voyage number if available | | `data[].attributes.timestamp` | string/null | Event timestamp (ISO 8601) if known | | `data[].attributes.location_locode` | string/null | UN/LOCODE for event location | | `data[].attributes.timezone` | string/null | Timezone for the event timestamps | | `data[].relationships.shipment.data` | object | Linked shipment resource identifier | | `data[].relationships.container.data` | object | Linked container resource identifier | | `data[].relationships.vessel.data` | object/null | Linked vessel resource identifier | | `data[].relationships.location.data` | object | Linked port/location resource identifier | | `data[].relationships.terminal.data` | object/null | Linked terminal resource identifier | ## Event Types Transport events include the following normalized event types: * **empty\_out**: Container emptied out * **full\_in**: Container filled in * **vessel\_loaded**: Container loaded onto vessel * **vessel\_departed**: Vessel departed with container * **transshipment\_arrived**: Container arrived at transshipment port * **transshipment\_loaded**: Container loaded at transshipment * **transshipment\_departed**: Container departed transshipment * **vessel\_arrived**: Vessel arrived at destination * **vessel\_discharged**: Container discharged from vessel * **full\_out**: Container filled out * **empty\_in**: Container emptied in ## Status Codes | Code | Description | | ---- | --------------------------------------- | | 200 | Transport events retrieved successfully | | 404 | Container not found | | 401 | Authentication failed - invalid API key | | 429 | Rate limit exceeded |