GET /delivery-zones — Zone Catalog with ETag Caching

GET /delivery-zones returns every governorate and area that Now Shipping serves. Every zone value you use in an order, exchange, return, or merchant pickup address must come verbatim from this endpoint — the API validates all zone strings against this catalog and rejects anything that doesn’t match exactly.

Always use areas[].value exactly as returned by this endpoint. Never abbreviate or paraphrase zone names — for example, "Nasr City" will be rejected; the correct value is "Nasr City - ElHay 06 (Nasr City)". Free text is not accepted anywhere in the API.

Authentication

Header	Value
`Authorization`	`Bearer nsk_live_YOUR_KEY`

No scope is required. Any valid API key can call this endpoint.

Caching with ETag

The zone catalog changes infrequently. The API returns an ETag header with every 200 response. On subsequent requests, send that value as If-None-Match — if the catalog hasn’t changed you receive 304 Not Modified with an empty body, saving bandwidth and latency.

Cache the zone list in your application at startup and refresh it on a daily schedule (or whenever you receive a zone-validation error). Store the ETag value alongside the cached data so you can send conditional requests.

Request

First request

curl "https://now.com.eg/api/public/v1/delivery-zones" \
  -H "Authorization: Bearer nsk_live_YOUR_KEY"

Conditional request (with ETag)

curl "https://now.com.eg/api/public/v1/delivery-zones" \
  -H "Authorization: Bearer nsk_live_YOUR_KEY" \
  -H "If-None-Match: \"abc123etag\""

When the catalog is unchanged, the server returns 304 Not Modified and your cached data remains valid.

Response

200 — Success

{
  "success": true,
  "data": {
    "meta": {
      "schemaVersion": 1,
      "governorateKeys": ["Cairo", "Giza", "Qalyubia"]
    },
    "governorates": [
      {
        "key": "Cairo",
        "value": "Cairo",
        "label": { "en": "Cairo", "ar": "القاهرة" },
        "areas": [
          {
            "value": "Nasr City - ElHay 06 (Nasr City)",
            "label": { "en": "Nasr City - ElHay 06 (Nasr City)", "ar": "..." }
          }
        ]
      }
    ]
  }
}

304 — Not Modified

Returned when the If-None-Match value matches the current catalog. The body is empty — continue using your cached data.

Response fields

object

Catalog metadata.

Show meta fields

number

Schema version of the catalog. Increment indicates a structural change.

string[]

Ordered list of governorate keys present in this response.

array

Array of governorate objects, each containing its areas.

Show governorate fields

string

Governorate key — use this value in the government field of order and fee requests (e.g. "Cairo").

string

Governorate value — identical to key in the current schema.

object

Localized display labels. Contains en and ar strings — use these to build your UI zone picker.

array

List of delivery areas within this governorate.

Show area fields

string

The exact string you must send in the zone field of every order create/update and in pickupAddress.zone during merchant onboarding.

object

Localized area labels (en, ar) for display purposes.

Usage pattern

Build your address form by iterating governorates and populating a zone dropdown from areas[].value for the selected governorate. Pass the selected areas[].value directly into your API requests — no transformation needed.

governorates[].key      →  order.government / pickupAddress.city
governorates[].areas[].value  →  order.zone / pickupAddress.zone

System

Merchants

Fees

Orders

Pickups

Reference

GET /delivery-zones — Zone Catalog with ETag Caching

Authentication

Caching with ETag

Request

First request

Conditional request (with ETag)

Response

200 — Success

304 — Not Modified

Response fields

Usage pattern

​Authentication

​Caching with ETag

​Request

​First request

​Conditional request (with ETag)

​Response

​200 — Success

​304 — Not Modified

​Response fields

​Usage pattern

Authentication

Caching with ETag

Request

First request

Conditional request (with ETag)

Response

200 — Success

304 — Not Modified

Response fields

Usage pattern