> ## Documentation Index
> Fetch the complete documentation index at: https://developers.govworx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# NENA EIDO incident events

> Use NENA EIDO as the recommended format for CAD incident events.

# NENA EIDO incident events

NENA is the National Emergency Number Association, the standards body for 9-1-1 and emergency
communications. EIDO, the Emergency Incident Data Object, is NENA's industry-standard format for
exchanging emergency incident information between systems.

GovWorx uses EIDO as the baseline format for the Connections Platform CAD interface. It gives CAD
providers a shared, industry-neutral structure rather than requiring a GovWorx-specific payload.
That makes the data easier to share with the systems an agency authorizes, while the agency remains
in control of its data.

An EIDO event is the recommended format for sending a complete CAD incident event to GovWorx.

An EIDO event contains the incident's complete current state. CAD sends a new event when the
incident is created or materially changes. GovWorx compares the event with its existing record and
applies the changes.

## Send an EIDO event

Send the EIDO object in the `data` field of an incident-event envelope:

```json theme={null}
{
  "tenantId": 12345,
  "provider": "primary-cad-interface",
  "format": "nena-eido",
  "format_version": "1.0",
  "timestamp": "2026-08-26T20:14:31Z",
  "data": {
    "$id": "urn:emergency:uid:incidentid:01J6Z8Y4NQ:agency.example.gov",
    "lastUpdateTimeStamp": "2026-08-26T20:14:30Z",
    "updatedByAgencyReference": { "$ref": "urn:emergency:uid:agency:agency.example.gov" },
    "eidoVersion": "1.0",
    "issuingElementIdentification": "cad.agency.example.gov",
    "agencyComponent": [
      {
        "$id": "urn:emergency:uid:agency:agency.example.gov",
        "lastUpdateTimeStamp": "2026-08-26T20:14:30Z",
        "updatedByAgencyReference": { "$ref": "urn:emergency:uid:agency:agency.example.gov" },
        "agencyRoleDescriptionRegistryText": ["incidentOwner"],
        "incidentOwningAgencyIndicator": true,
        "agencyType": ["ems"]
      }
    ],
    "incidentComponent": {
      "$id": "urn:emergency:uid:eidodatacomponent:incident:agency.example.gov",
      "lastUpdateTimeStamp": "2026-08-26T20:14:30Z",
      "updatedByAgencyReference": { "$ref": "urn:emergency:uid:agency:agency.example.gov" },
      "internalIncidentId": "CAD-12345",
      "incidentTypeInternalCode": "MEDICAL",
      "incidentTypeInternalText": "Medical emergency",
      "incidentTypeCommonRegistryText": "medical",
      "incidentStatusInternalText": ["DISP"],
      "incidentStatusCommonRegistryText": ["dispatched"],
      "incidentPriorityInternalText": "high",
      "locationReference": [{ "$ref": "urn:emergency:uid:eidodatacomponent:location:agency.example.gov" }],
      "notesReference": [{ "$ref": "urn:emergency:uid:eidodatacomponent:note-1:agency.example.gov" }]
    },
    "locationComponent": [
      {
        "$id": "urn:emergency:uid:eidodatacomponent:location:agency.example.gov",
        "lastUpdateTimeStamp": "2026-08-26T20:14:30Z",
        "updatedByAgencyReference": { "$ref": "urn:emergency:uid:agency:agency.example.gov" },
        "locationTypeDescriptionRegistryText": "incidentLocation",
        "locationDescriptionText": "100 Main St, Denver, CO 80202"
      }
    ],
    "notesComponent": [
      {
        "$id": "urn:emergency:uid:eidodatacomponent:note-1:agency.example.gov",
        "lastUpdateTimeStamp": "2026-08-26T20:14:30Z",
        "updatedByAgencyReference": { "$ref": "urn:emergency:uid:agency:agency.example.gov" },
        "notesActionComments": "Caller reports chest pain."
      }
    ]
  }
}
```

The event must meet the EIDO schema. `internalIncidentId` identifies the CAD incident within the
incident component. This example includes the required EIDO data references. Use the NENA schema
below to validate the complete object.

<Card title="Publish an incident event" icon="paper-plane" href="/connections-platform/api-reference/send-incidents-to-govworx/publish-an-incident-event" horizontal>
  Review the request envelope and the other supported event formats.
</Card>

## Other formats

EIDO is recommended, not required. A connector profile can define another CAD format and map it
to the GovWorx incident model when the CAD cannot produce EIDO.

Lifecycle signals such as `incident.started`, `incident.canceled`, and the asynchronous
`incident.linked` fallback carry limited state. They do not replace a complete EIDO incident event
for normal CAD updates.

## NENA schema

GovWorx pins the NENA EIDO 1.0.1 normative schema for the CAD contract. NENA maintains the
standard and its schema; GovWorx does not substitute a proprietary incident-data format for it.
This portal links to that source rather than copying it. GovWorx reviews NENA releases and adopts
them deliberately, with a published contract update, so integrations always know the EIDO version
they are building against.

<Card title="NENA standards" icon="landmark" href="https://www.nena.org/page/standards" horizontal>
  Learn about the National Emergency Number Association and the standards it maintains for 9-1-1.
</Card>

<Card title="NENA EIDO 1.0.1 schema" icon="file-code" href="https://github.com/NENA911/EIDO-JSON/blob/1ea5750ba2ef4ea3ec572622e8bf571d68b1d32/Schema/openapi.yaml" horizontal>
  Review the normative EIDO schema maintained by NENA.
</Card>