Upload Incident

curl --request PUT \
  --url https://app.govworx.net/api/v1/external/incident \
  --header 'Content-Type: application/json' \
  --data '
{
  "sysId": "INC-2026-001234",
  "number": "26-001234",
  "incidentType": "Medical Emergency - Cardiac Arrest",
  "incidentDate": "2026-01-06T10:25:00Z",
  "callTakerId": "CT-456",
  "closedAt": "2026-01-06T11:45:00Z",
  "caseNumber": "CR-2026-9876",
  "priority": "Priority 1",
  "callerNumber": "555-123-4567",
  "callerName": "John Smith",
  "agency": "CITY-FIRE-01",
  "agencyType": "Fire",
  "dispatchQueueAt": "2026-01-06T10:30:00Z",
  "disposition": "Transport to Hospital",
  "location": 123,
  "latitude": 40.7128,
  "longitude": -74.006,
  "callPosition": "Position-01",
  "callTakerName": "Jane Doe",
  "callSource": "E911",
  "initialIncidentType": "Chest Pain",
  "additionalContext": "Caller reports patient experiencing chest pain and shortness of breath for 30 minutes",
  "responseArea": "Beat-3-Downtown",
  "radioChannel": "FIRE-TAC-1",
  "callReceivedTime": "2026-01-06T10:23:00Z",
  "callPickupTime": "2026-01-06T10:23:15Z",
  "callHangupTime": "2026-01-06T10:28:00Z",
  "notes": [
    {
      "noteId": "<string>",
      "note": "<string>",
      "noteBy": "<string>",
      "noteAt": "2023-11-07T05:31:56Z"
    }
  ],
  "responders": [
    {
      "personnelId": "<string>",
      "personnelFirstName": "<string>",
      "personnelLastName": "<string>",
      "unitName": "<string>",
      "dispatchedBy": "<string>",
      "dispatchedAt": "2023-11-07T05:31:56Z",
      "enrouteAt": "2023-11-07T05:31:56Z",
      "arrivedAt": "2023-11-07T05:31:56Z",
      "clearedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "relatedSysId": "INC-2026-001233"
}
'

Incident

Upload Incident

Upload a new incident to the system. Token must have ‘Manage Events’ permission. System will only upload incident once, using the sysId to prevent duplicates. Important: Do NOT include the ‘id’ field in your request - use ‘sysId’ to identify incidents from your source system. By default, timestamps are assumed to be in UTC and will be converted to the tenant’s local timezone. Set convertFromUtc=false if your timestamps are already in local time.

PUT

api

external

incident

Upload Incident

curl --request PUT \
  --url https://app.govworx.net/api/v1/external/incident \
  --header 'Content-Type: application/json' \
  --data '
{
  "sysId": "INC-2026-001234",
  "number": "26-001234",
  "incidentType": "Medical Emergency - Cardiac Arrest",
  "incidentDate": "2026-01-06T10:25:00Z",
  "callTakerId": "CT-456",
  "closedAt": "2026-01-06T11:45:00Z",
  "caseNumber": "CR-2026-9876",
  "priority": "Priority 1",
  "callerNumber": "555-123-4567",
  "callerName": "John Smith",
  "agency": "CITY-FIRE-01",
  "agencyType": "Fire",
  "dispatchQueueAt": "2026-01-06T10:30:00Z",
  "disposition": "Transport to Hospital",
  "location": 123,
  "latitude": 40.7128,
  "longitude": -74.006,
  "callPosition": "Position-01",
  "callTakerName": "Jane Doe",
  "callSource": "E911",
  "initialIncidentType": "Chest Pain",
  "additionalContext": "Caller reports patient experiencing chest pain and shortness of breath for 30 minutes",
  "responseArea": "Beat-3-Downtown",
  "radioChannel": "FIRE-TAC-1",
  "callReceivedTime": "2026-01-06T10:23:00Z",
  "callPickupTime": "2026-01-06T10:23:15Z",
  "callHangupTime": "2026-01-06T10:28:00Z",
  "notes": [
    {
      "noteId": "<string>",
      "note": "<string>",
      "noteBy": "<string>",
      "noteAt": "2023-11-07T05:31:56Z"
    }
  ],
  "responders": [
    {
      "personnelId": "<string>",
      "personnelFirstName": "<string>",
      "personnelLastName": "<string>",
      "unitName": "<string>",
      "dispatchedBy": "<string>",
      "dispatchedAt": "2023-11-07T05:31:56Z",
      "enrouteAt": "2023-11-07T05:31:56Z",
      "arrivedAt": "2023-11-07T05:31:56Z",
      "clearedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "relatedSysId": "INC-2026-001233"
}
'

Query Parameters

convertFromUtc

boolean

default:true

Body

application/json

Incident data transfer object for creating or updating incidents

sysId

string

required

Unique system identifier from your source CAD system. This is used to prevent duplicate incidents.

Example:

"INC-2026-001234"

number

string

required

Incident number or call sign displayed to users

Example:

"26-001234"

incidentType

string

required

Incident type / problem nature / call type classification

Example:

"Medical Emergency - Cardiac Arrest"

incidentDate

string<date-time>

required

Date and time when the incident was created in the CAD system. Subject to timezone conversion based on convertFromUtc parameter (defaults to UTC). Used as fallback for callPickupTime/callReceivedTime if those are missing.

Example:

"2026-01-06T10:25:00Z"

callTakerId

string

required

The personnel ID of the call taker. This field gets mapped to the user's Personnel ID in the system to associate users with events

Example:

"CT-456"

closedAt

string<date-time>

required

Timestamp when the incident was closed in the CAD system. Subject to timezone conversion (defaults to UTC).

Example:

"2026-01-06T11:45:00Z"

caseNumber

string

Case report number if assigned to the incident

Example:

"CR-2026-9876"

priority

string

Priority level of the incident as assigned by CAD

Example:

"Priority 1"

callerNumber

string

The primary caller's phone number

Example:

"555-123-4567"

callerName

string

The primary caller's name

Example:

"John Smith"

agency

string

Agency identifier responding to or handling the incident

Example:

"CITY-FIRE-01"

agencyType

string

Type of agency (e.g., Fire, Police, EMS, Aeromedical)

Example:

"Fire"

dispatchQueueAt

string<date-time>

Timestamp when the incident was added to the dispatch queue. Subject to timezone conversion based on convertFromUtc parameter (defaults to UTC).

Example:

"2026-01-06T10:30:00Z"

disposition

string

Final disposition or outcome of the incident

Example:

"Transport to Hospital"

location

string

Address or location description of the incident

Example:

123

latitude

string

Latitude coordinate of the incident location (decimal degrees)

Example:

40.7128

longitude

string

Longitude coordinate of the incident location (decimal degrees)

Example:

-74.006

callPosition

string

The position/workstation that the call taker who received the call was sitting in. Used for call audio matching and analytics.

Example:

"Position-01"

callTakerName

string

Name of the call taker who handled the incident

Example:

"Jane Doe"

callSource

string

Information about how the incident was initiated. Typically indicates channels such as Admin Line, E911, Field Initiated, etc.

Example:

"E911"

initialIncidentType

string

Initial incident type as reported when call was first received. May differ from final incidentType if call was reclassified.

Example:

"Chest Pain"

additionalContext

string

Additional context, comments, or narrative about the incident

Example:

"Caller reports patient experiencing chest pain and shortness of breath for 30 minutes"

responseArea

string

Geographic response area, jurisdiction, beat, or ORI code. Used for routing and organizational purposes.

Example:

"Beat-3-Downtown"

radioChannel

string

Radio channel assigned for communications on this incident

Example:

"FIRE-TAC-1"

callReceivedTime

string<date-time>

Time the call was received by the system. Required for matching call audio. Subject to timezone conversion (defaults to UTC). If both callReceivedTime and callPickupTime are missing, both will be populated from incidentDate. Can be the earliest timestamp indicating the call taker has begun creating a CAD incident.

Example:

"2026-01-06T10:23:00Z"

callPickupTime

string<date-time>

Time the call was answered/picked up. Required for matching call audio. Subject to timezone conversion (defaults to UTC). If not provided, this will be auto-populated from callReceivedTime if available, otherwise from incidentDate if both callPickupTime and callReceivedTime are missing. Can be the earliest timestamp indicating the call taker has begun creating a CAD incident.

Example:

"2026-01-06T10:23:15Z"

callHangupTime

string<date-time>

Time the call ended/hung up. Required for matching call audio. Subject to timezone conversion (defaults to UTC).

Example:

"2026-01-06T10:28:00Z"

notes

object[]

List of notes/comments associated with the incident. Timestamps are subject to timezone conversion.

Show child attributes

responders

object[]

List of responders/units assigned to the incident. Timestamps are subject to timezone conversion.

Show child attributes

System ID (sysId) of a related or parent incident for linking incidents together. Used to establish relationships between incidents (e.g., duplicate calls, related events).

Example:

"INC-2026-001233"

Response

200

Introduction List Users

API documentation

API Reference

Realtime API Reference

Upload Incident

Query Parameters

Body

Response