GET/api/v1/logistics/shipments/{id}/track

Live shipment tracking

Live tracking payload — the rider's current position, lifecycle stamps, pickup/dropoff contacts + coordinates, and a freshness timestamp. Poll every 10–30 seconds to power a buyer-facing tracking page. The `stage` field collapses our internal status into one of: `awaiting_pickup`, `en_route_pickup`, `en_route_dropoff`, `delivered`, `cancelled`.

Authorization

Requires the logistics:read scope. See the auth guide for how to mint a token with the right scopes.

Parameters

Path parameters

Field	Type	Description
id required	string	Shipment CUID. e.g. shp_2k8h1mv9c3xq

Response

A successful call returns 200 OK with the body shown to the right. Errors follow the standard envelope.

Request

curl 'https://theyutes.com/api/v1/logistics/shipments/shp_2k8h1mv9c3xq/track' \
  -H 'Authorization: Bearer tyk_••••••••••••••••••••••••••••••••'

Response · 200 OK

json

{
  "data": {
    "id": "shp_2k8h1mv9c3xq",
    "status": "en_route_pickup",
    "stage": "en_route_pickup",
    "rider": {
      "id": "drv_1abc23",
      "name": "Tunde A.",
      "lat": 6.4474,
      "lng": 3.4593,
      "lastPingAt": "2026-05-28T14:34:12.000Z",
      "vehicleType": "motorcycle"
    },
    "pickup": {
      "lat": 6.4502,
      "lng": 3.4595,
      "address": "12 Bourdillon Road, Ikoyi, Lagos",
      "contactName": "Ọnọ Lagos",
      "contactPhone": "+234 801 234 5678"
    },
    "dropoff": {
      "lat": 6.4382,
      "lng": 3.4221,
      "address": "21 Glover Road, Ikoyi, Lagos",
      "contactName": "Adaeze O.",
      "contactPhone": "+234 802 999 0000"
    },
    "lifecycle": {
      "createdAt": "2026-05-28T14:20:00.000Z",
      "enRouteAt": "2026-05-28T14:32:00.000Z",
      "pickedUpAt": null,
      "deliveredAt": null,
      "estimatedDelivery": "2026-05-28T14:52:00.000Z",
      "quotedEta": "2026-05-28T14:50:00.000Z"
    },
    "routeKm": 2.1,
    "freshSeconds": 14
  }
}