GET/api/v1/logistics/surge

Zone surge multiplier

Current zone surge multiplier (1.0–2.5) for a city, computed from real-time supply/demand over the last 15 minutes. Same formula the dispatcher uses internally so the buyer-facing badge always matches the charged fare. Use it to surface a 'high demand' notice in your storefront before checkout.

Authorization

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

Parameters

Query parameters

Field	Type	Description
city required	string	City name. Case-insensitive. e.g. Lagos

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/surge?city=Lagos' \
  -H 'Authorization: Bearer tyk_••••••••••••••••••••••••••••••••'

Response · 200 OK

json

{
  "data": {
    "city": "Lagos",
    "surgeMultiplier": 1.42,
    "pendingShipments": 18,
    "availableRiders": 7,
    "windowMinutes": 15,
    "computedAt": "2026-05-28T14:33:21.000Z"
  }
}