POSTAPI key

Force a re-poll

POSTapi.trackingmcp.com/v1/containers/{id}/recheck

Ask the connectors to refresh this box now, rather than waiting for the next cycle.

Path parameters

idstringrequired

The container UUID.

Response fields

Derived from the example response.

okboolean

Whether the request succeeded.

dataobject

The payload. Everything an endpoint returns sits under this key.

data.recheckstring

Reads "started" once the re-poll is queued.

data.idstring

Stable identifier for the record. On the tracking endpoints this is the container UUID, except on a portfolio summary row, where it is the container number.

Errors

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

UNAUTHORIZED401

The key is missing, malformed or revoked.

NOT_FOUND404

No container with that UUID on your account.

RATE_LIMITED429

This box was rechecked too recently. Carriers publish on their own cadence, so a second recheck within the window would return the same data.

curl -X POST 'https://api.trackingmcp.com/v1/containers/8f1c2d4e-6a3b-4f52-9c70-11ab22cd33ef/recheck' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"

const res = await fetch("https://api.trackingmcp.com/v1/containers/8f1c2d4e-6a3b-4f52-9c70-11ab22cd33ef/recheck", {
  method: "POST",
  headers: {
    "Authorization": "Bearer tmcp_YOUR_API_KEY"
  }
});
const data = await res.json();

import requests

res = requests.post(
    "https://api.trackingmcp.com/v1/containers/8f1c2d4e-6a3b-4f52-9c70-11ab22cd33ef/recheck",
    headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json()

Response

{
  "ok": true,
  "data": {
    "recheck": "started",
    "id": "8f1c2d4e-6a3b-4f52-9c70-11ab22cd33ef"
  }
}