List zones

GET /v1/tenant/zones

A zone is a geographic area where your tenant operates, identified by a zone_code such as zone_lisbon_central. Each zone linked to your tenant carries its own connectivity state, which drives how wede delivers events there.

Authentication

API key or session token with the zones:view permission. The integration API key has it, and so do all tenant roles (company_admin, company_tech, operational_supervisor, field_operator, corporate_client).

API key: x-wede-api-key: wede_live_... or wede_test_...
Session token: Authorization: Bearer <token>

You get the zones linked to the credential’s tenant.

This endpoint returns the real connectivity state of each zone, also for a sandbox key. To read the simulated sandbox state, call GET /v1/connectivity/status with your sandbox key.

Example

curl https://api.wede.pt/v1/tenant/zones \
  -H "x-wede-api-key: wede_live_YOUR_KEY"

Response `200`

{
  "zones": [
    {
      "id": "4f1c2a0e-6b1d-4a57-9d0e-2f1b7c3d8e21",
      "zone_code": "zone_lisbon_central",
      "name": "Lisboa Central",
      "country": "PT",
      "region": "Lisboa",
      "lat_center": "38.716900",
      "lng_center": "-9.139900",
      "boundary": null,
      "created_at": "2026-05-01T10:00:00.000Z",
      "verticals_active": ["healthcare"],
      "connectivity_state": "online",
      "incident_active": false,
      "last_state_change": "2026-06-09T17:00:00.000Z"
    }
  ],
  "total": 1
}

object[]

Zones linked to your tenant, ordered by name.

string

Zone UUID. This is the value of zone_id on teams.

string

Zone code. Use it in the zone URLs and as metadata.zone_id on events.

string

Display name.

string

ISO 3166-1 alpha-2 country code.

string | null

Region or district.

string | null

Latitude of the zone centre, as a decimal string.

string | null

Longitude of the zone centre, as a decimal string.

object[] | null

Zone outline as a list of { lat, lng } points.

string

ISO 8601 timestamp.

string[]

Verticals your tenant runs in this zone.

string

online, degraded, sms_only, voice_only or offline.

boolean

Whether an incident is flagged in the zone.

string

When the zone settings or connectivity state last changed.

integer

Number of zones returned.

Errors

Status	`error`	When
`401`	`unauthorized`	Missing, invalid or revoked credentials.
`403`	`forbidden`	The credential lacks `zones:view`.
`500`	`internal_error`	Unexpected server error.

SDKs

listZones in JavaScript, list_zones in Python.

Overview

Authentication

Events

Teams & Dispatch

Missions

Zones

Billing

Tenant

Webhooks

Sync

Connectivity

Sandbox

Parsers

Onboarding

Authentication

Example

Response `200`

Errors

SDKs

​Authentication

​Example

​Response 200

​Errors

​SDKs

Authentication

Example

Response `200`

Errors

SDKs