---
title: "List available edge zones"
method: GET
path: "/v1/Webhooks/EdgeZones"
tags: ["EdgeZones"]
---

# List available edge zones

`GET /v1/Webhooks/EdgeZones`

## Request

- Base URL: `https://webhooks.twilio.com`
- URL: `https://webhooks.twilio.com/v1/Webhooks/EdgeZones`
- Auth: HTTP basic

Returns the edge zone catalog for webhook delivery. Supports pagination via `pageSize`
and `pageToken` (see [Pagination](#section/Pagination)).

**Read-only discovery endpoint** - use this to fetch available zone IDs
before creating Settings.

### Usage

Edge zones control geographic webhook delivery. Twilio selects the best available
PoP within the zone at delivery time.

1. Call this endpoint to get available edge zones and their constituent PoPs
2. Use the zone `id` values in `Settings.edgeZones` when creating Settings

If edge zones are not specified in Settings, webhooks use the home region (same as the processing region).

## Query parameters

- `pageSize` integer
- `pageToken` string

## Response `200`

Zone catalog with nested edge location inventory

- EdgeZonesList: Response body for GET /EdgeZones.
  - `edgeZones` EdgeZone[], required
    - `id` string, required: Stable zone identifier. Use this value in Settings.edgeZones.
    - `friendlyName` string, required: Human-readable zone name.
    - `description` string, required: Routing guidance for this zone.
    - `edgeLocations` EdgeLocation[], required: PoPs currently active within this zone.
      - `id` string, required: PoP identifier in `{IATA}-{n}` format (e.g. `DUB-1`). Appears in `X-Twilio-Edge-Location` response header. Not valid for use in Settings.edgeZones.
      - `city` string, required: City where the PoP is located.
      - `country` string, required: ISO 3166-1 alpha-2 country code.
  - `meta` PaginationMeta: Pagination metadata containing navigation tokens and result information, this schema should according to convention be added to the response payload's 'meta' attribute
    - `key` string, required: The key of the list property contains the actual data items. This enables programmatic iteration over paginated results.
    - `pageSize` integer, required: The page size used for this request (the requested value, or the default/max-capped value if none was requested). The number of items actually returned in the list may be less than this on the last page.
    - `previousToken` string, nullable: Token to fetch the previous page of results. Only included if there is a previous page, otherwise omitted.
    - `nextToken` string, nullable: Token to fetch the next page of results. Only included if there is a next page, otherwise omitted.

## Other responses

- `401`: Authentication failed
- `403`: Authenticated account does not have permission to perform this operation
- `429`: Rate limit exceeded
- `500`: An unexpected server error occurred

---

[API](https://skmtc.dev/twilio/apis/webhooks-v1.md) - [All operations](https://skmtc.dev/twilio/apis/webhooks-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/webhooks-v1/revisions/629b4cc3a029?raw)
