POSTAPI key

Start tracking

POSTapi.trackingmcp.com/v1/containers

Add a container, bill of lading or booking to your account. We resolve the carrier, backfill history and keep it live.

Request body

referencestringrequired

Container number, bill of lading or booking reference.

carrierstring

Optional carrier SCAC hint. Omit and we detect it.

Response fields

Derived from the example response.

okboolean

idstring

referencestring

carrierstring

statusstring

created_atstring

curl -X POST https://api.trackingmcp.com/v1/containers \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reference":"MEDU1234562"}'

const res = await fetch("https://api.trackingmcp.com/v1/containers", {
  method: "POST",
  headers: {
    "Authorization": "Bearer tmcp_YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "reference": "MEDU1234562"
  })
});
const data = await res.json();

import requests

res = requests.post(
    "https://api.trackingmcp.com/v1/containers",
    headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
    json={
      "reference": "MEDU1234562"
    },
)
data = res.json()

Response

{
  "ok": true,
  "id": "ctr_9Fk2mQ",
  "reference": "MEDU1234562",
  "carrier": "MSC",
  "status": "pending",
  "created_at": "2026-08-04T09:12:00Z"
}