List parsers

A parser is the field schema your tenant uses for a vertical: the list of fields a mission or event of that vertical carries, with their type, size and protection rules. Each vertical can have several numbered versions; the active parser of a vertical is its highest active version.

Authentication

Session token (Authorization: Bearer <token>) with the parsers:read permission. Tenant roles with it: company_admin, company_tech, operational_supervisor, corporate_client. Parsers are tenant content: wede staff roles do not have parsers:read and cannot read them.

The integration API key (x-wede-api-key) has no parsers:* permission. Calls with an API key return 403 forbidden.

The parser object

string

Parser UUID.

string

Your tenant.

string

Vertical code, for example healthcare.

integer

Version number within the vertical, starting at 1.

string

Display name.

string | null

Description.

boolean

Whether this version is active.

object[]

Field definitions. See Create a parser.

string | null

UUID of the user who created it.

string

ISO 8601 timestamp.

string

ISO 8601 timestamp.

GET /v1/parsers

Returns every parser version of your tenant, ordered by vertical and then by version, newest first.

curl https://api.wede.pt/v1/parsers \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"

Response 200

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tenant_id": "9c145f7e-83be-4039-8e9c-650796acd3ee",
      "vertical": "healthcare",
      "version": 2,
      "name": "Healthcare v2",
      "description": null,
      "is_active": true,
      "schema": [
        {
          "id": "hc_eid",
          "name": "event_id",
          "sms_code": "eid",
          "type": "string",
          "required": true,
          "enabled": true,
          "description": "Unique event identifier",
          "offline_capable": true,
          "section": "core",
          "max_bytes": 12,
          "is_dispatch_action": false,
          "locked": false
        }
      ],
      "created_by": "327739d2-79b6-4e10-8699-a1393e70dbb8",
      "created_at": "2026-05-19T14:00:00.000Z",
      "updated_at": "2026-05-19T14:00:00.000Z"
    }
  ],
  "count": 1
}

Get a parser

GET /v1/parsers/{id}

string

required

Parser UUID.

Returns the parser object.

Get the active parser of a vertical

GET /v1/parsers/vertical/{vertical}/active

string

required

Vertical code.

Returns the highest active version for the vertical.

curl https://api.wede.pt/v1/parsers/vertical/healthcare/active \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"

Errors

Status	`error`	When
`401`	`unauthorized`	Missing, invalid or expired credentials.
`403`	`forbidden`	Your role lacks `parsers:read`, or you used an API key.
`404`	`not_found`	No parser with this `id` in your tenant, or no active parser for the vertical.
`500`	`internal_error`	Unexpected server error.

SDKs

listParsers, getParser and getActiveParser in JavaScript; list_parsers, get_parser and get_active_parser in Python.

Overview

Authentication

Events

Teams & Dispatch

Missions

Zones

Billing

Tenant

Webhooks

Sync

Connectivity

Sandbox

Parsers

Onboarding

List parsers

Authentication

The parser object

List parsers

Get a parser

Get the active parser of a vertical

Errors

SDKs

​Authentication

​The parser object

​List parsers

​Get a parser

​Get the active parser of a vertical

​Errors

​SDKs

Authentication

The parser object

List parsers

Get a parser

Get the active parser of a vertical

Errors

SDKs