GETAPI key

DCSA event feed

GETapi.trackingmcp.com/v2/events

Track and Trace events in the DCSA 2.2 shape, for systems that already speak the standard. This surface follows the standard rather than our envelope: it answers a bare JSON array, and pagination rides in the response headers. Null or absent fields are omitted from an event rather than sent as null.

Query parameters

equipmentReferencestring

Filter to one container number.

eventTypestring

Filter to one category: SHIPMENT, TRANSPORT or EQUIPMENT.

limitinteger

Page size. Default 100, capped at 500.

Response fields

Derived from the example response.

[].eventIDstring

UUID for the event, stable across calls. Use it to deduplicate.

[].eventCreatedDateTimestring

When we recorded the event, which is not when it happened. Read eventDateTime for that.

[].eventTypestring

DCSA event category: SHIPMENT, TRANSPORT or EQUIPMENT.

[].eventClassifierCodestring

ACT for actual, EST for estimated, PLN for planned. Never assume a PLN or EST move has occurred.

[].eventDateTimestring

Event timestamp (ISO 8601).

[].equipmentEventTypeCodestring

DCSA equipment event code.

[].equipmentReferencestring

Container number.

[].emptyIndicatorCodestring

EMPTY or LADEN, on equipment events only. Present only when the carrier reported the fill state, and absent otherwise: the standard has no unknown value and we do not invent one. It is not an end-of-shipment signal, so read the container status instead.

[].transportCallobject

Location, vessel and voyage of the port call. Absent when the carrier filed none.

[].transportCall.locationobject

UN/LOCODE for the event, or null when the carrier gave no place.

[].transportCall.location.UNLocationCodestring

UN/LOCODE.

Errors

A failure carries { "ok": false, "error": { "code", "message", "severity" } }. Branch on the code, and log the message.

invalidQuery400

A limit or cursor the standard does not allow. This surface returns the DCSA error shape, not ours.

UNAUTHORIZED401

The key is missing, malformed or revoked.

curl 'https://api.trackingmcp.com/v2/events' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"

const res = await fetch("https://api.trackingmcp.com/v2/events", {
  headers: {
    "Authorization": "Bearer tmcp_YOUR_API_KEY"
  }
});
const data = await res.json();

import requests

res = requests.get(
    "https://api.trackingmcp.com/v2/events",
    headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json()

Response

[
  {
    "eventID": "b21f0c65-1d4a-4a3e-9f77-2ac0d5e8b190",
    "eventCreatedDateTime": "2026-06-18T22:14:03Z",
    "eventType": "EQUIPMENT",
    "eventClassifierCode": "ACT",
    "eventDateTime": "2026-06-18T22:10:00Z",
    "equipmentEventTypeCode": "LOAD",
    "equipmentReference": "MEDU1234562",
    "emptyIndicatorCode": "LADEN",
    "transportCall": { "location": { "UNLocationCode": "CNNGB" } }
  }
]