List events

GET /v1/events

Authentication

API key or session token with the events:read permission. API keys have it. An API key lists only the events of its own environment. A session lists production events unless it passes environment=sandbox.

Query parameters

string

Filter by status: pending, completed or failed.

string

Filter by event type, exactly as sent (for example cardiac_arrest).

string

Filter by the code of a category of your catalog, for example pre. See GET /v1/catalog.

string

Filter by vertical, for example healthcare.

string

Filter by zone code, for example zone_lisbon_central.

boolean

true returns only events whose type sends a team (requires_teams) and that have no active mission: no mission, or missions that all ended FAILED. This is the dispatch queue of the optional teams and dispatch module. Any other value is ignored.

boolean

true returns open events sent before 8 October 2026 with a type that is not in your catalog. They were delivered but never dispatched; close them or leave them to their own flow.

integer

default:"50"

Events per page, from 1 to 200. Values above 200 are capped at 200.

string

The next_cursor of the previous page. Omit it for the first page.

string

Sessions only: production (default) or sandbox. Ignored for API keys, which always read their own environment.

Example

curl "https://api.wede.pt/v1/events?vertical=healthcare&status=pending&limit=25" \
  -H "x-wede-api-key: wede_live_YOUR_KEY"

To read the dispatch queue:

curl "https://api.wede.pt/v1/events?undispatched=true&vertical=healthcare" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"

Response

200 OK

{
  "data": [
    {
      "event_id": "0ee3dfbe-6a0b-4c55-9d0e-2b7f3f1c9a40",
      "type": "cardiac_arrest",
      "category": "pre",
      "category_name": "Pre-hospital emergency",
      "requires_teams": true,
      "dispatchable": true,
      "vertical": "healthcare",
      "priority": "critical",
      "status": "completed",
      "channel_used": "rest_full",
      "created_at": "2026-09-26T09:12:04.512Z",
      "updated_at": "2026-09-26T09:12:04.690Z",
      "zone_id": "zone_lisbon_central",
      "environment": "production"
    }
  ],
  "next_cursor": "MjAyNi0wOS0yNlQwOToxMjowNC41MTIzNDVafDBlZTNkZmJl...",
  "total_count": 142
}

object[]

Events on this page, newest first.

Show properties

string

Event ID (UUID).

string

Event type as sent. Not returned to wede staff roles.

string | null

Code of the category of your catalog the type belongs to; null for an event with a type that is no longer in your catalog. Not returned to wede staff roles.

string | null

Name of that category. Not returned to wede staff roles.

boolean

true when the type sends a field team. dispatchable carries the same value and is kept for clients of SDK 2.4.1.

string

Vertical.

string

low, normal, high or critical.

string

pending, completed or failed. See Get event.

string | null

Delivery channel: rest_full, rest_compressed, sms, voice, satellite, lora, edge or queued_offline. null until wede has processed the event.

string

When wede received the event.

string

Last change.

string | null

Zone code, or null if the event has no zone.

string

production or sandbox.

string | null

Pass it as cursor to get the next page. null on the last page.

integer

Number of events that match your filters, across all pages.

The list does not include the payload or metadata. Use GET /v1/events/:event_id for a single event.

Paging through all results

cursor=""
while :; do
  page=$(curl -s "https://api.wede.pt/v1/events?limit=200${cursor:+&cursor=$cursor}" \
    -H "x-wede-api-key: wede_live_YOUR_KEY")
  echo "$page" | jq -c '.data[]'
  cursor=$(echo "$page" | jq -r '.next_cursor // empty')
  [ -z "$cursor" ] && break
done

Errors

Status	Code	When
401	`unauthorized`	Credential missing, malformed, revoked or expired
403	`forbidden`	The credential lacks `events: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

Paging through all results

Errors

​Authentication

​Query parameters

​Example

​Response

​Paging through all results

​Errors

Authentication

Query parameters

Example

Response

Paging through all results

Errors