GET/api/v1/logistics/zones

Active delivery zones

Lists the cities we currently have rider supply in, with each zone's available rider count, pending shipment count, surge multiplier, and a `coverage` flag (`live` once we have ≥5 active riders, else `limited`). Drives coverage maps and 'will we deliver to X?' checks in third-party UIs.

Authorization

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

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

Response · 200 OK

json

{
  "data": {
    "zones": [
      {
        "city": "Lagos",
        "country": "NG",
        "availableRiders": 47,
        "pendingShipments": 12,
        "surgeMultiplier": 1.32,
        "coverage": "live"
      },
      {
        "city": "Ibadan",
        "country": "NG",
        "availableRiders": 6,
        "pendingShipments": 1,
        "surgeMultiplier": 1,
        "coverage": "live"
      }
    ],
    "generatedAt": "2026-05-28T14:33:21.000Z"
  }
}