Retrieve Transport Events | Terminal49 API Documentation

Get a container's transport events

curl --request GET \
  --url https://api.terminal49.com/v2/containers/{id}/transport_events \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.terminal49.com/v2/containers/{id}/transport_events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.terminal49.com/v2/containers/{id}/transport_events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.terminal49.com/v2/containers/{id}/transport_events"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.terminal49.com/v2/containers/{id}/transport_events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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
        }
      }
    }
  ],
  "links": {
    "self": "https://api.terminal49.com/v2/containers/eeafd337-72b5-4e5c-87cb-9ef83fa99cf4/transport_events",
    "current": "https://api.terminal49.com/v2/containers/eeafd337-72b5-4e5c-87cb-9ef83fa99cf4/transport_events?page[number]=1"
  }
}

GET

containers

{id}

transport_events

Get a container's transport events

curl --request GET \
  --url https://api.terminal49.com/v2/containers/{id}/transport_events \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.terminal49.com/v2/containers/{id}/transport_events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.terminal49.com/v2/containers/{id}/transport_events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.terminal49.com/v2/containers/{id}/transport_events"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.terminal49.com/v2/containers/{id}/transport_events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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
        }
      }
    }
  ],
  "links": {
    "self": "https://api.terminal49.com/v2/containers/eeafd337-72b5-4e5c-87cb-9ef83fa99cf4/transport_events",
    "current": "https://api.terminal49.com/v2/containers/eeafd337-72b5-4e5c-87cb-9ef83fa99cf4/transport_events?page[number]=1"
  }
}

This endpoint returns the container’s normalized transport event history — vessel, rail, transshipment, terminal/gate, delivery, and document events — across the entire journey. It does not accept filters for event type, data source, or timestamp. To narrow results to a subset (for example, terminal-only events such as full_in, full_out, empty_out, empty_in, vessel_discharged, vessel_arrived, or vessel_berthed), fetch the list and filter client-side on attributes.event or attributes.data_source.

Pagination

The response follows the standard Terminal49 pagination shape: a links object (self, current, next, prev, last) and a meta object with size (page size) and total (total events for the container). Most containers have far fewer transport events than one page, so links.next is usually absent and a single request returns the full history. When a container does have more events than fit on one page, follow links.next until it is absent. Do not construct pagination URLs by hand — use the URLs returned in links.

Event types

The attributes.event field is one of a fixed set of normalized event names covering vessel, rail, transshipment, feeder, terminal/gate, inland-destination, availability, and delivery milestones. The complete enum is defined on the transport_event schema in the OpenAPI spec and mirrored in the Webhook Event Catalog, which describes what each event means. The attributes.data_source field indicates where the event originated: shipping_line, terminal, or ais.

Estimated event types

Three estimated event types can appear in the response:

container.transport.estimated.vessel_departed
container.transport.estimated.vessel_arrived
container.transport.estimated.arrived_at_inland_destination

These are the only estimated events in transport_events. Feeder, rail, and transshipment events exist only as actual milestones here. For estimated timestamps on those event types, use the deprecated raw events endpoint, which flags estimates with an attributes.estimated boolean on any event type.

Null locations and timezones

Some events may have a null location_locode and timezone — most commonly on estimated events. See Event Timestamps for details on how to interpret those timestamps.

`transport_events` vs `raw_events`

transport_events is the recommended endpoint for milestone data. Events are normalized across carriers and go through additional vetting to reduce false positives. raw_events is deprecated and returns the carrier feed as-is; it contains more events but with less consistent normalization. See Get a container’s raw events for details.

Authorizations

Authorization

string

header

required

Use a Terminal49 API key in the Authorization header with the Token prefix.

Authorization: Token YOUR_API_KEY

Path Parameters

string

required

Query Parameters

include

string

Comma delimited list of relations to include

Response

200 - application/json

data

Transport Event Model · object[]

Show child attributes

included

Show child attributes

links

links · object

Show child attributes

Tracking Requests

Shipments

Containers

Documents

Email Submissions

Document Schemas

Document Representations

Search

Webhooks

Webhook Notifications

Custom Field Definitions

Custom Field Options

Custom Fields

Shipping Lines

Metro Areas

Ports

Vessels

Terminals

Parties

Get a container's transport events

Event types

Estimated event types

Null locations and timezones

`transport_events` vs `raw_events`

Authorizations

Path Parameters

Query Parameters

Response

​Pagination

​Event types

​Estimated event types

​Null locations and timezones

​transport_events vs raw_events

Authorizations

Path Parameters

Query Parameters

Response

Pagination

Event types

Estimated event types

Null locations and timezones

`transport_events` vs `raw_events`