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 schema

16 fields

Derived from the example response, nested as the JSON is.

[]object

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).

trackingMcpSourceobject

Our own provenance block, added alongside the standard fields: which source produced the event and how confidently it was normalised. Ignore it if you want a purely standard payload.

providerstring

Machine name of the producer.

normalisationConfidencestring

REPORTED, INFERRED or UNKNOWN, the camelCase twin of normalisation_confidence.

equipmentEventTypeCodestring

DCSA equipment event code.

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.

equipmentReferencestring

Container number.

transportCallobject

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

locationobject

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

locationNamestring

Location name as the source wrote it.

eventLocationobject

Event location.

locationNamestring

Location name as the source wrote it.

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": "a94b2e10-33d7-4c8a-b0f1-6d2e7c9a4b55",
    "eventCreatedDateTime": "2026-08-03T10:29:07.255Z",
    "eventType": "EQUIPMENT",
    "eventClassifierCode": "ACT",
    "eventDateTime": "2026-05-07T08:00:00.000Z",
    "trackingMcpSource": {
      "provider": "trackingmcp",
      "normalisationConfidence": "INFERRED"
    },
    "equipmentEventTypeCode": "GTOT",
    "emptyIndicatorCode": "EMPTY",
    "equipmentReference": "MEDU1234562",
    "transportCall": {
      "location": {
        "locationName": "Tyne Container Services QLD Pty Ltd"
      }
    },
    "eventLocation": {
      "locationName": "Tyne Container Services QLD Pty Ltd"
    }
  }
]