GETAPI key

Endpoint detail and deliveries

GETapi.freightratesmcp.com/v1/webhooks/{id}

One endpoint plus its 20 most recent delivery attempts. This is where you look when an event did not arrive: status is pending, delivered or dead, and last_error carries either HTTP <code> or the transport error we saw. Read, so a valid key is enough. Answers 404 not_found for an unknown id or one on another account.

Path parameters

idstringrequired

Endpoint id from registration.

Response schema

18 fields

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

dataobject

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

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.

urlstring

Where we POST the events.

event_typesstring[]

The events this endpoint receives. Anything not listed is not delivered.

descriptionstring

The carrier own phrasing for the event, falling back to our word for the code.

activeboolean

False while the endpoint is paused. A paused endpoint keeps its secret and its history.

failure_countnumber

Consecutive failed deliveries. It resets on the first success, and a sustained climb is what disables an endpoint.

last_delivery_atstring

When we last attempted a delivery. Null before the first one.

created_atstring

When the record was created (ISO 8601).

recent_deliveriesobject[]

The last deliveries with their outcome, which is enough to debug an integration without asking us.

recent_deliveries[]object

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.

event_typestring

DCSA event category: SHIPMENT, TRANSPORT or EQUIPMENT.

statusstring

Current normalised status of the shipment. Ocean lifecycle order: discharged, available, delivered, returned_empty. Two values end a shipment, delivered and returned_empty, and returned_empty outranks delivered.

attempt_countnumber

How many times this one delivery was attempted, retries included.

last_status_codenumber

HTTP status your endpoint answered with on the last attempt. Null when the request never got an answer, for example on a timeout.

last_errorstring | null

What went wrong on the last attempt. Null on a delivered event.

created_atstring

When the record was created (ISO 8601).

delivered_atstring

When your endpoint accepted the event. Null while it is still failing or queued.

curl 'https://api.freightratesmcp.com/v1/webhooks/3f1c9a4e-7b52-4f0e-9a41-2c9d5e6b8a10' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"

const res = await fetch("https://api.freightratesmcp.com/v1/webhooks/3f1c9a4e-7b52-4f0e-9a41-2c9d5e6b8a10", {
  headers: {
    "Authorization": "Bearer tmcp_YOUR_API_KEY"
  }
});
const data = await res.json();

import requests

res = requests.get(
    "https://api.freightratesmcp.com/v1/webhooks/3f1c9a4e-7b52-4f0e-9a41-2c9d5e6b8a10",
    headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json()

Response

{
  "data": {
    "id": "3f1c9a4e-7b52-4f0e-9a41-2c9d5e6b8a10",
    "url": "https://hooks.example.com/freightratesmcp",
    "event_types": ["lane_rate_updated", "index_refreshed"],
    "description": "Rate moves, procurement channel",
    "active": true,
    "failure_count": 0,
    "last_delivery_at": "2026-08-11T09:14:31.204Z",
    "created_at": "2026-08-11T09:12:04.881Z",
    "recent_deliveries": [
      { "id": "a94b2e10-33d7-4c8a-b0f1-6d2e7c9a4b55",
        "event_type": "ping",
        "status": "delivered",
        "attempt_count": 1,
        "last_status_code": 200,
        "last_error": null,
        "created_at": "2026-08-11T09:14:30.010Z",
        "delivered_at": "2026-08-11T09:14:31.204Z" }
    ]
  }
}