Skip to main content
PUT
/
api
/
v1
/
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": "CALL-5678",
  "caseNumber": "CASE-2026-9876",
  "priority": "High Priority",
  "incidentType": "Medical Emergency",
  "callerNumber": "555-123-4567",
  "callerName": "John Smith",
  "agency": "City Fire Department",
  "agencyType": "Fire",
  "dispatchQueueAt": "2026-01-06T10:30:00Z",
  "incidentDate": "2026-01-06T10:25:00Z",
  "disposition": "Transport to Hospital",
  "location": 123,
  "latitude": 40.7128,
  "longitude": -74.006,
  "callPosition": "Dispatcher-01",
  "callTakerId": "DISP-456",
  "callTakerName": "Jane Doe",
  "callSource": 911,
  "initialIncidentType": "Chest Pain",
  "additionalContext": "Caller reports patient experiencing chest pain and shortness of breath",
  "responseArea": "Zone 3 - Downtown",
  "radioChannel": "FIRE-TAC-1",
  "callReceivedTime": "2026-01-06T10:23:00Z",
  "callPickupTime": "2026-01-06T10:23:15Z",
  "callHangupTime": "2026-01-06T10:28:00Z",
  "closedAt": "2026-01-06T11:45:00Z",
  "notes": [
    {
      "noteId": "<string>",
      "noteBy": "<string>",
      "note": "<string>",
      "noteAt": "2023-11-07T05:31:56Z"
    }
  ],
  "responders": [
    {
      "personnelId": "<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",
      "personnelFirstName": "<string>",
      "personnelLastName": "<string>"
    }
  ],
  "relatedSysId": "INC-2026-001233"
}
'

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

Incident number or call sign

Example:

"CALL-5678"

​
caseNumber
string

Case number associated with the incident

Example:

"CASE-2026-9876"

​
priority
string

Priority level of the incident

Example:

"High Priority"

​
incidentType
string

Type or classification of the incident

Example:

"Medical Emergency"

​
callerNumber
string

Phone number of the caller

Example:

"555-123-4567"

​
callerName
string

Name of the caller

Example:

"John Smith"

​
agency
string

Agency responding to or handling the incident

Example:

"City Fire Department"

​
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

Example:

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

​
incidentDate
string<date-time>

Date and time when the incident occurred

Example:

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

​
disposition
string

Final disposition or outcome of the incident

Example:

"Transport to Hospital"

​
location
string

Location or address of the incident

Example:

123

​
latitude
string

Latitude coordinate of the incident location

Example:

40.7128

​
longitude
string

Longitude coordinate of the incident location

Example:

-74.006

​
callPosition
string

Position or role of the person handling the call

Example:

"Dispatcher-01"

​
callTakerId
string

Unique identifier for the call taker

Example:

"DISP-456"

​
callTakerName
string

Name of the call taker

Example:

"Jane Doe"

​
callSource
string

Source or method of the incoming call

Example:

911

​
initialIncidentType
string

Initial incident type as reported when call was received

Example:

"Chest Pain"

​
additionalContext
string

Additional context or notes about the incident

Example:

"Caller reports patient experiencing chest pain and shortness of breath"

​
responseArea
string

Geographic response area or zone

Example:

"Zone 3 - Downtown"

​
radioChannel
string

Radio channel used for communications

Example:

"FIRE-TAC-1"

​
callReceivedTime
string<date-time>

Timestamp when the call was initially received

Example:

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

​
callPickupTime
string<date-time>

Timestamp when the call was answered/picked up

Example:

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

​
callHangupTime
string<date-time>

Timestamp when the call ended

Example:

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

​
closedAt
string<date-time>

Timestamp when the incident was closed

Example:

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

​
notes
object[]

List of notes associated with the incident

​
responders
object[]

List of responders assigned to the incident

​
relatedSysId
string

System ID of a related incident (for linking incidents together)

Example:

"INC-2026-001233"

Response

200

OK