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

Get a shipment

Returns the full shipment detail — status, carrier, cost, tracking URL, ETA, last-known location, and the failover audit trail if auto-failover ran at dispatch time. Works for both order-bound shipments and external API shipments.

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' \
  -H 'Authorization: Bearer tyk_••••••••••••••••••••••••••••••••'

Response · 200 OK

json

{
  "data": {
    "id": "shp_2k8h1mv9c3xq",
    "status": "in_transit",
    "carrier": "fez",
    "carrierName": "Fez Delivery",
    "costKobo": 180000,
    "trackingUrl": "https://track.fezdelivery.com/FEZ-8X2L9KQ",
    "providerShipmentId": "FEZ-8X2L9KQ",
    "merchantReference": "PHR-1242",
    "pickedUpAt": "2026-05-27T11:48:00.000Z",
    "estimatedDelivery": "2026-05-27T12:42:00.000Z",
    "deliveredAt": null,
    "lastKnownLat": 6.5244,
    "lastKnownLng": 3.3792,
    "lastPingAt": "2026-05-27T12:14:23.000Z",
    "pickup": {
      "address": "15 Adeola Odeku, Victoria Island",
      "city": "Lagos"
    },
    "dropoff": {
      "address": "Allen Avenue, Ikeja",
      "city": "Lagos"
    },
    "failoverAttempts": [
      {
        "carrier": "uber",
        "error": "No riders available in pickup zone (Victoria Island).",
        "attemptedAt": "2026-05-27T11:30:00.000Z"
      },
      {
        "carrier": "fez",
        "error": null,
        "attemptedAt": "2026-05-27T11:30:04.000Z"
      }
    ],
    "createdAt": "2026-05-27T11:30:00.000Z"
  }
}