List delivery zones

GEThttps://api.nexgapp.com/v1/zonesLive

Returns the zones NexG delivers to, sorted by name. Each zone carries a bounding box, so you can tell whether a point is roughly inside it, and the delivery times guests are quoted there.

The box is an approximation of the zone’s shape. Whether an exact address can be served is decided by NexG at checkout.

Authentication: None needed. A key with public_read gets its own rate limit.
Rate limit cost: 1 token
Caching: Shared caches, 300 seconds
Available since: 21 October 2026

curl "https://api.nexgapp.com/v1/zones" \
  -H "X-Api-Key: $NEXG_API_KEY"

Response · 200 OK

{
  "ok": true,
  "data": {
    "items": [
      {
        "id": "7f1e2d3c-4b5a-4968-8776-655443322110",
        "city_id": "c1a5e2d4-7b3f-4e8a-9c6d-2f1b0e4a8d37",
        "name": "Kilimani",
        "tier": "core",
        "eta_min": 20,
        "eta_max": 30,
        "cod_allowed": true,
        "west": 36.765,
        "south": -1.3,
        "east": 36.8,
        "north": -1.27
      },
      {
        "id": "8a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
        "city_id": "c1a5e2d4-7b3f-4e8a-9c6d-2f1b0e4a8d37",
        "name": "Westlands",
        "tier": "core",
        "eta_min": 25,
        "eta_max": 35,
        "cod_allowed": true,
        "west": 36.795,
        "south": -1.275,
        "east": 36.83,
        "north": -1.245
      }
    ],
    "next_cursor": null
  },
  "meta": {
    "api_version": "v1",
    "limit": 100
  }
}

Headers

X-Api-Keyheader · stringOptional
Your API key. Or send it as Authorization: Bearer <key>, but never both in one request.

Response

Zone data.items[]

iduuid
The zone’s id.
city_iduuid
The city the zone belongs to.
namestring
The zone’s name, for example Westlands.
tierstring or null
core, extended or trial: how established delivery is in the zone.
eta_mininteger or null
Shortest typical delivery time, in minutes.
eta_maxinteger or null
Longest typical delivery time, in minutes.
cod_allowedboolean or null
Whether cash on delivery is offered in the zone.
westnumber or null
Bounding box: western longitude.
southnumber or null
Bounding box: southern latitude.
eastnumber or null
Bounding box: eastern longitude.
northnumber or null
Bounding box: northern latitude.

Errors

Every error has the same shape; see Errors. Branch on error.code and the HTTP status, never on the message.

400invalid_request
Both X-Api-Key and Authorization were sent, or Authorization is not a Bearer key.
401not_found
The key is unknown, revoked or expired, or its merchant cannot use the API right now. All of these get the same answer on purpose.
403not_found
A key was sent but it does not have public_read.
429rate_limited
Your token bucket is empty. Wait the number of seconds in the Retry-After header.
503internal_error
NexG could not check the key or the rate limit. Retry with backoff.
500internal_error
NexG could not read the zones.
500internal_error
Something unexpected failed on NexG’s side. NexG logs the X-Request-Id: quote it if you report the failure.

Good to know

Zones are a small set and change rarely, so the whole list comes in one response.