Connectivity status

GET /v1/connectivity/status

Returns the current connectivity state of every zone linked to your tenant. wede uses this state to choose how events from each zone are delivered.

Authentication

API key or session token with the connectivity:read permission. API keys have it. With a sandbox key (wede_test_), each zone shows its simulated sandbox state: online unless you changed it with POST /v1/sandbox/simulate-connectivity or POST /v1/connectivity/report. Production keys and sessions see the real state.

Query parameters

string

Zone code, for example zone_lisbon_central. Returns only that zone.

Example

curl "https://api.wede.pt/v1/connectivity/status?zone_id=zone_lisbon_central" \
  -H "x-wede-api-key: wede_live_YOUR_KEY"

Response

200 OK

{
  "zones": [
    {
      "zone_id": "zone_lisbon_central",
      "zone_name": "Lisboa Centro",
      "country": "PT",
      "state": "sms_only",
      "incident_active": false,
      "last_updated": "2026-09-26T09:00:02.511Z",
      "fallback_channel": "sms"
    }
  ],
  "as_of": "2026-09-26T09:03:40.090Z"
}

object[]

Your zones, ordered by name. Empty if no zone matches.

Show properties

string

Zone code.

string

Zone name.

string

Country code of the zone.

string

online, degraded, sms_only, voice_only or offline.

boolean

Whether an incident is open for this zone.

string | null

When the state last changed.

string

Path that matches the state: rest_full (online), rest_degraded (degraded), sms (sms_only), voice (voice_only), offline (offline).

string

Time of the response.

Connectivity states

State	Meaning
`online`	Internet connectivity is normal
`degraded`	Internet connectivity is unreliable. `high` and `critical` events use `rest_compressed`
`sms_only`	Only the cellular network is available for messaging
`voice_only`	Only voice calls are available
`offline`	No connectivity

In sms_only, voice_only and offline, wede delivers through your channel cascade. See Create event. To be notified of changes instead of polling, subscribe to connectivity.degraded and connectivity.restored. See Webhook events.

Errors

Status	Code	When
401	`unauthorized`	Credential missing, malformed, revoked or expired
403	`forbidden`	The credential lacks `connectivity:read`
503	`service_unavailable`	The API key could not be validated right now. Retry

Overview

Authentication

Events

Teams & Dispatch

Missions

Zones

Billing

Tenant

Webhooks

Sync

Connectivity

Sandbox

Parsers

Onboarding

Authentication

Query parameters

Example

Response

Connectivity states

Errors

​Authentication

​Query parameters

​Example

​Response

​Connectivity states

​Errors

Authentication

Query parameters

Example

Response

Connectivity states

Errors