Skip to main content

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

HeaderTypeRequiredDescription
X-API-KeystringYesYour API key for authentication

Path Parameters

ParameterTypeRequiredDescription
idstringYesThe unique identifier of the container

Response Format

Success Response (200 OK)

{
  "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

FieldTypeDescription
data[].idstringTransport event ID
data[].typestringAlways transport_event
data[].attributes.eventstringNormalized event (e.g., container.transport.vessel_loaded)
data[].attributes.created_atstringRecord creation timestamp (ISO 8601)
data[].attributes.voyage_numberstring/nullVoyage number if available
data[].attributes.timestampstring/nullEvent timestamp (ISO 8601) if known
data[].attributes.location_locodestring/nullUN/LOCODE for event location
data[].attributes.timezonestring/nullTimezone for the event timestamps
data[].relationships.shipment.dataobjectLinked shipment resource identifier
data[].relationships.container.dataobjectLinked container resource identifier
data[].relationships.vessel.dataobject/nullLinked vessel resource identifier
data[].relationships.location.dataobjectLinked port/location resource identifier
data[].relationships.terminal.dataobject/nullLinked 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

CodeDescription
200Transport events retrieved successfully
404Container not found
401Authentication failed - invalid API key
429Rate limit exceeded