Pulsepoint.org

PulsePoint API Reference Guide

This reference guide provides a detailed technical reference of the authentication, resources, and examples for use with the PulsePoint API. This reference guide is targeted at inbound data from computer-aided dispatch (CAD) systems into the life-saving PulsePoint application.

Contents

Introduction

Before You Start

Register Your Agency

REST Interface

HTTPs vs. HTTP

Base URL

Authentication

REST Resources

Incidents

Unit

Incident/Call Types

Medical Priority Dispatch Codes

Dispatch Status Codes

Introduction

The PulsePoint mobile app empowers everyday citizens to provide life-saving assistance to victims of Sudden Cardiac Arrest by crowd-sourcing nearby Good Samaritans to events where the potential need for bystander CPR is high. The PulsePoint Foundation is a nonprofit organization established to guide, enhance and expand the reach of the PulsePoint application. The foundation provides a service to fire departments, EMS agencies and other Public Safety Answer Points (PSAP) to enable them to easily integrate their computer-aided dispatch (CAD) data into the PulsePoint mobile application (via this API).

Before You Start

Local public safety agencies must register with the PulsePoint Foundation in order to use the PulsePoint API.  Upon registration, you will receive an api key along with a username and password for use with the PulsePoint API.

Register Your Agency

For more information on how to register your agency, please register your organization with Pulse Point Foundation or contact us directly for assistance.

REST Interface

We designed the PulsePoint API in a very RESTful way, so that the consumption of the PulsePoint API is hopefully more simple and straightforward than traditional integration techniques can be over the Internet like using flat-files or SOAP-based XML messaging. REST's client/server separation of concerns simplifies component implementation, reduces the complexity of connector semantics, improves the effectiveness of performance tuning, and increases the scalability of pure server components. Layered system constraints allow intermediaries-proxies, gateways, and firewalls-to be introduced at various points in the communication without changing the interfaces between components, thus allowing them to assist in communication translation or improve performance via large-scale, shared caching. REST enables intermediate processing by constraining messages to be self-descriptive: interaction is stateless between requests, standard methods and media types are used to indicate semantics and exchange information, and responses explicitly indicate cache-ability.

HTTPs vs. HTTP

HTTP stands for HyperText Transport Protocol, which is just a fancy way of saying it's a protocol for information to be passed back and forth on the Internet. HTTPs is a combination of HTTP together with the SSL/TLS protocol to provide encrypted communication and secure identification. The PulsePoint API leverages only HTTPs for data communication in order to ensure data privacy. HTTP is not supported.

Base URL

The following represents the base URL for all PulsePoint API requests:

PRODUCTION (Version 1 Production Endpoint)

SANDBOX (Version 1 Sandbox Endpoint)

Authentication

All PulsePoint API requests are authenticated using HTTP Basic Authentication (or Basic Auth). To obtain your username and password for use with the PulsePoint API, register your organization with the PulsePoint Foundation. Upon approval of your registration, you will receive credentials for both the DEVELOPMENT/TESTING SANDBOX environment as well as the PRODUCTION environment.

REST Resources

Incidents

The Incident resource provides the ability for agency incident data to be sent to the PulsePoint Foundation for use in the application.

Resource URL - POST

Query Parameters

Request Method(s)

Request Format(s)

Content Type (HTTP Accept-Type)

Resource URL - GET

      -or-

Query Parameters

Request Method(s)

Request Format(s)

Request

Parameter

Type

Constraint(s)

Description

Sample Value

Note(s)

AgencyID

String

REQUIRED

ON ALL POSTS

(used in mobile app)

Your unique five-character Fire Department Identification (FDID) number, if assigned. EMD agencies, among others, may not have an FDID.

"07035"

As assigned for use with the National Fire Incident Reporting System (or as determined in conjunction with the foundation). 

See http://nfirs.fema.gov for additional information.

Validated off of Registration -- Must match API Key.

TransactionID

String(30)

REQUIRED

(used in mobile app)

Agency-based unique transaction number assigned for the inbound transaction.

“50000191”

Correlates back to original data in CAD system

IncidentNumber

String(30)

REQUIRED 

ON ALL POSTS

(used in mobile app)

Unique 9-digit NFIRS incident number (include the two date digits -- first 2 digit represent the year).

"1100091597"

As assigned for use with the National Fire Incident Reporting System (or as determined in conjunction with the foundation). 

See http://nfirs.fema.gov for additional information.

EventNumber

String(30)

Additional incident reference number.

"F11002077"

CaseNumber

String(30)

Additional incident reference number.

"12581258"

EMDIncidentNumber

String(30)

Additional cross-referencing incident number.

"2011-90234-4"

CallSource

String(10)

Source of call origination.

"PBX"

StreetNumber

String(15)

(used in mobile app)

Grouped Address Data

Numeric component of physical street address.

"1500"

Predirectional

String(2)

(used in mobile app)

Grouped Address Data

The compass directional identification appearing before the street name such as N Main or NW Main..

"S"

Use United States Postal Service (USPS) standards to support geocoding and other external referencing.

See http://pe.usps.com/cpim/ftp/pubs/Pub28/pub28.pdf for additional information.

StreetName

String(text)

(used in mobile app)

Grouped Address Data

Primary physical street name.

"Main"

CAD Systems that do not support components address information should leverage the StreetName to upload their address line information.

StreetSuffix

String(10)

(used in mobile app)

Grouped Address Data

The word that follows the name of a street to further describe that street, such as Road or Court.

"St"

Use United States Postal Service (USPS) standards to support geocoding and other external referencing.

See http://pe.usps.com/cpim/ftp/pubs/Pub28/pub28.pdf for additional information.

Postdirectional

String(2)

(used in mobile app)

Grouped Address Data

The compass directional identification appearing after the street name such as Main Street SW.

"W"

Use United States Postal Service (USPS) standards to support geocoding and other external referencing.

See http://pe.usps.com/cpim/ftp/pubs/Pub28/pub28.pdf for additional information.

Suite

String(15)

(used in mobile app)

Grouped Address Data

Suite or apartment number.

"202"

Building

String(15)

(used in mobile app)

Grouped Address Data

Building identification number.

"5"

Floor

String(15)

(used in mobile app)

Grouped Address Data

Building floor number.

"2"

CityOrLocality

String(60)

(used in mobile app)

Grouped Address Data

City, town, CDP or other address locality.

"San Ramon"

Spell city, town or locality names in their entirety. Abbreviations cause problems with our geodecoding.

County

String(50)

County or similar geographic subdivision such as Parish or Borough.

"Contra Costa"

Name of County/Parish/Borough.  Do not include descriptor in the string. e.g., ‘Suffolk’, not ‘Suffolk County’; ‘Orleans’, not ‘Orleans Parish’

StateOrProvince

String(50)

(used in mobile app)

Grouped Address Data

Must be a valid state or province code based on the ISO 3166-2 Standard.

State or province.

"CA"

Must be a valid state or province code based on the ISO 3166-2 Standard within the country where your Comm Center is registered with the PulsePoint API

*Note: v1 supports US and CA only.

PostalCode

String(15)

Grouped Address Data

ZIP code or postal code primarily used for the sorting of mail.

"94583"

US - 5 digit and 5+4 digit formats supported

CAN - 6 character string supported

CommonPlaceName

String(100)

(used in mobile app)

Common place name or business name such as Central Park or Ironhorse School.

"Central Park"

CrossStreet1

String(50)

(used in mobile app)

Street name and suffix defining an intersection when combined with CrossStreet2 or street name and suffix intersecting the primary street near the street number.

"Monte Sereno Dr"

CrossStreet2

String(50)

(used in mobile app)

Street name and suffix defining an intersection when combined with CrossStreet1 or street name and suffix intersecting the primary street near the street number.

"Stone Valley Rd"

Longitude

Number

REQUIRED

(used in mobile app)

*Note: As a backup, this value will be populated through geolocation of the Grouped Address information if not provided

A geographic coordinate that specifies the east-west position of a point on the Earth's surface.

-121.994762420654

or

6129596.069

Decimal Format (WGS84) [default]

Use WGS84 standard expressed as decimal degrees. Valid range is

-180 to +180; "-" for West and "+" for East (of the Prime Meridian).

or 

Easting foot/meter value if you have selected one of the State Plane coordinate types in your Agency account configuration.  If you do ‘POST’ State Plane values, remember that any ‘GET’ will return the value converted to WGS84.

Latitude

Number

REQUIRED

(used in mobile app)

*Note: As a backup, this value will be populated through geolocation of the Grouped Address information if not provided

A geographic coordinate that specifies the south-north position of a point on the Earth's surface.

37.7718002733786

or

2107081.186

Decimal Format (WGS84) [default]

Use WGS84 standard expressed as decimal degrees. Valid range is -90 to +90; "+" for North and "-" for South (of the equator).

or 

Northing foot/meter value if you have selected one of the State Plane coordinate types in your Agency account configuration. If you do ‘POST’ State Plane values, remember that any ‘GET’ will return the value converted to WGS84.

Elevation

Number

Height in feet above sea level of the location.

110

PublicLocation

Boolean

(used in mobile app)

*Note: This will be populated through an external API using the Grouped Address information if not provided

Indicates if this is a public location; 0=No, 1=Yes, Null=API will attempt to determine.

Determining this value locally is the preferred method since it is likely the most accurate source. If PublicLocation is set to 1 (true) then providing CommonPlaceName is strongly recommended.

LocationComment

String(text)

(used in mobile app)

Descriptive location information such as specific patient location or additional response directions.

"Patient in Aisle #12"

ResponderRadius

String(6)

Validation: (".125",".1875",".25",".5","1","2" miles)

Responder radius in miles.

  .125.

Acts as override to radius set in agency configuration. If not present, agency config values will be used.

VerifiedResponderRadius

String(6)

Validation: (".125",".1875",".25",".5","1","2" miles)

Verified Responder radius in miles.

  .5

Acts as override to radius set in agency configuration. If not present, agency config values will be used.

PopulationDensity

String(15)

Validation: (Urban, Suburban, Rural, or Wildland)

Population per unit area definitions such Urban, Suburban, Rural and Wildland.

"Urban"

FireManagementZone

String(50)

User-defined geographic reference area.

"34001"

FirstDueStation

String(15)

User-defined geographic reference area representing primary fire station.

"34"

Battalion

String(50)

User-defined geographic reference area such as Bureau, Beat, Ward and Battalion.

"31"

Jurisdiction

String(50)

User-defined intra-agency juisdiction identifier

“E320”

SuppressInApp

Boolean

(used in mobile app)

Indicates if the incident should be suppressed in the mobile app; 0=No, 1=Yes, Null (not sent) defaults to 0=No (display incident)

“1”

Use to hide incidents that agency doesn’t want displayed in the App.

PulsePointIncidentCallType

String(15)

REQUIRED ON CREATE

(used in mobile app)

Must be a valid PulsePoint Incident Call Type.

Incident/call type code.

"ME"

Valid call types are defined in this specification.

See Incident/Call Types below.

The application uses this predefined set of incident types to simplify notifications and other user interactions.

AgencyIncidentCallType

String(15)

Incident/call type code of agency (not normalized).

"MED"

This is the original native (agency) incident call type before conversion to a standard type.

AgencyIncidentCallTypeDescription

String(100)

Text description of agency defined incident/call type (not normalized).

"Medical Assist"

AgencyIncidentCallSubType

String(15)

Incident/call subtype.

"SOB"

AgencyIncidentCallSubTypeDescription

String(100)

Text description of incident/call subtype.

"Shortness of Breath"

PulsePointDeterminantCode

String(15)

(used in mobile app)

Must be a valid PulsePoint Determinant Code.

Determinant code (protocol end point) of the Medical Priority Dispatch System (MPDS).

"09E02"

Valid MPDS Determinant Codes (Medical Priority Dispatch Codes) are defined in this specification.

See Medical Priority Dispatch Codes below.

AgencyDeterminantCode

String(15)

User-defined EMS Determinant code (protocol end point) of an emergency medical dispatch system other than MPDS.

"CPR01"

AlarmLevel

String(2)

validation off of NFIRS

(used in mobile app)

Incident level expressed in alarms.

2

Alarm level displayed in app if provided
(above 1).

NFIRS specification needed for validation

Priority

String(15)

Indicate the severity of the incident and/or level of response such as Alpha, Bravo, Charlie, Delta, and Echo.

"Echo"

CommandName

String(50)

Assigned incident name.

"Sycamore IC"

TacticalChannel

String(15)

Assigned radio channel for incident.

"TAC22"

CallReceivedDateTime

DateTime

REQUIRED

ON CREATE

(used in mobile app)

Date and time call was received.

2011-03-17T11:03:58-08:00

All system timeouts for incident keyed from this value.

EMDDeterminantCompleteDateTime

DateTime

(used in mobile app)

Date and time EMS determinate code was entered.

2011-03-17T11:04:28-08:00

DispatchDateTime

DateTime

REQUIRED

(used in mobile app)

Date and time call was dispatched.

2011-03-17T11:04:20-08:00

Needed to derive response time statistics.

EnrouteDateTime

DateTime

(used in mobile app)

Date and time first unit was enroute to incident.

2011-03-17T11:05:12-08:00

OnSceneDateTime

DateTime

REQUIRED

(used in mobile app)

Date and time first unit was onscene at incident.

2011-03-17T11:09:16-08:00

CPR alert window closes for PulsePoint responder(s) when an EMS/Fire unit is on scene. Also, needed to derive response time statistics.

WorkingFireDateTime

DateTime

Date and time “working fire” was declared.

2011-03-17T11:09:20-08:00

AmbulanceArrivalDateTime

DateTime

(used in mobile app)

Date and time first ambulance arrived onscene.

2011-03-17T11:10:11-08:00

PatientSideDateTime

DateTime

(used in mobile app)

Date and time agency personnel arrived at patient.

2011-03-17T11:11:42-08:00

EffectiveResponseForceDateTime

DateTime

(used in mobile app)

Date and time Effective Response Force was onscene at incident.

2011-03-17T11:16:20-08:00

UnderControlDateTime

DateTime

(used in mobile app)

Date and time call was declared “Under Control”.

2011-03-17T12:03:44-08:00

ClosedDateTime

DateTime

REQUIRED

(used in mobile app)

Date and time last unit was cleared from incident.

2011-03-17T11:03:58-08:00

Incident moves from ‘Active’ to ‘Recent’ tab in the PulsePoint app when a ClosedDateTime is posted. Also, call duration is calculated using this value (in conjunction with EntryDateTime)

WorkstationID

String(15)

Originating workstation identifier.

"Disp-3"

EntryDateTime

DateTime

REQUIRED

(used in mobile app)

Date and time call was created in dispatch system.

2011-03-17T11:04:10-08:00

Call duration is calculated using this value (in conjunction with ClosedDateTime)

IncidentLastUpdate

TimeStamp

Updated by system. Do not submit.

Timestamp of last record update.

2011-03-17T11:04:25-08:00

Unit

List

(used in mobile app)

Array of Unit objects

Unit

The Unit resource provides information about the units that are dispatched to an incident.

Parameter

Type

Constraints

Description

Sample Value

Notes

UnitDispatchNumber

String(30)

REQUIRED

(used in mobile app) 

Unique identification number or key value associated with a dispatched unit.

"10009087"

This number should remain the same for all updates for this unit. If the unit clears the incident and is subsequently dispatched again to the same incident a new number should be assigned.

UnitID

String(20)

REQUIRED

(used in mobile app)

Radio, dispatch, or “known as” identifier of unit, such as E31.

"E31"

VehicleNumber

String(10)

Vehicle identification or maintenance number.

"336"

PulsePointDispatchStatus

String(10)

REQUIRED 
ON CREATE

(used in mobile app)

Must be a valid PulsePoint Dispatch Status Code

Current dispatch status of unit.

"OS"

Valid Dispatch Status Codes are defined in this specification.

See Dispatch Statuses below.

The application uses this predefined set of dispatch status codes to standardize the interface and improve the user experience.

AgencyDispatchStatus

String(10)

Current dispatch status of unit using agency codes (not normalized).

"XC"

This is the original native (agency) dispatch status code before conversion to a standard type.

ResponsePriority

String(10)

User-defined response priority.

"2"

UnitDispatchDateTime

DateTime

(used in mobile app)

Date and time unit was dispatched.

2011-03-17T11:04:20-08:00

UnitAcknowledgeDateTime

DateTime

(used in mobile app)

Date and time unit acknowledged dispatch.

2011-03-17T11:11:12-08:00

UnitEnrouteDateTime

DateTime

(used in mobile app)

Date and time unit was enroute to incident.

2011-03-17T11:05:22-08:00

UnitOnSceneDateTime

DateTime

(used in mobile app)

Date and time unit was onscene at incident.

2011-03-17T11:11:12-08:00

UnitTransportStartDateTime

DateTime

(used in mobile app)

Date and time unit began transport to hospital.

2011-03-17T11:19:16-08:00

UnitTransportArriveDateTime

DateTime

(used in mobile app)

Date and time unit arrived at hospital.

2011-03-17T11:27:16-08:00

UnitAvailableOnEventDateTime

DateTime

(used in mobile app)

Date and time unit became available while remaining on event.

2011-03-17T11:03:33-08:00

UnitClearedDateTime

DateTime

(used in mobile app)

Date and time unit was cleared from incident.

2011-03-17T11:03:48-08:00

UnitInQuartersDateTime

DateTime

(used in mobile app)

Date and time last unit arrived in quarters.

2011-03-17T15:13:28-08:00

TransportLocation

String(50)

Name of destination hospital.

"Stanford"

TransportPriority

String(20)

User-defined transport priority.

"3"

TransportMileageStart

Number

Starting mileage for use when transport begins.

0

TransportMileageEnd

Number

Ending mileage for use when transport ends at receiving facility.

10

Response

Response Format(s)

Parameter

Type

Description

Sample Value

Notes

StatusCode

String

The HTTP Return Code

"201"

See Response Status Codes for the list of valid response codes that can be returned

StatusDescription

String

Description of the error if the transaction is not successful, or general status if successful.

“IncidentNumber missing. All requests must contain AgencyID, TransactionID and IncidentNumber.”

Response Status Codes

DateTime Format

For all DateTime parameters, use [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss]±[hh]:[mm] format for all DateTime values. See http://en.wikipedia.org/wiki/ISO_8601 for additional information. Also see http://www.iso.org/iso/support/faqs/faqs_widely_used_standards/widely_used_standards_other/date_and_time_format.htm.

Grouped Address Data

If any field in the “address group” fields is updated, all of the fields in the “address group” that are not updated will be cleared.  Therefore, you should always update all address fields together instead of updating just a single field (i.e. don’t send in just the apartment number).

Sample Requests

Request Format

{

   "AgencyID":"07035",

   "TransactionID":"50000156",

   "IncidentNumber":"1100091567",

   "EventNumber":"F11002077",

   "CaseNumber":"12581258",

   "EMDIncidentNumber":"2011-90234-4",

   "CallSource":"PBX",

   "StreetNumber":"1500",

   "Predirectional":"S",

   "StreetName":"Main",

   "StreetSuffix":"St",

   "Postdirectional":"W",

   "Suite":"202",

   "Building":"5",

   "Floor":"2",

   "CityOrLocality":"San Ramon",

   "County":"Contra Costa",

   "StateOrProvince":"CA",

   "PostalCode":"94583",

   "CommonPlaceName":"Central Park",

   "CrossStreet1":"Monte Sereno Dr",

   "CrossStreet2":"Stone Valley Rd",

   "Longitude":-121.994762,

   "Latitude":37.771801,

   "Elevation":"350",

   "LocationComment":"Patient in Aisle #12",

   "PopulationDensity":"Urban",

   "FireManagementZone":"34001",

   "FirstDueStation":"34",

   "Battalion":"31",

   "PublicLocation":1,

   "PulsePointIncidentCallType":"ME",

   "AgencyIncidentCallType":"MED",

   "AgencyIncidentCallTypeDescription":"Medical Assist",

   "AgencyIncidentCallSubType":"SOB",

   "AgencyIncidentCallSubTypeDescription":"Shortness of Breath",

   "PulsePointDeterminantCode":"09E02",

   "AgencyDeterminantCode":"CPR01",

   "AlarmLevel":"2",

   "Priority":"Echo",

   "CommandName":"Sycamore IC",

   "TacticalChannel":"TAC22",

   "CallReceivedDateTime":"2011-03-17T11:03:58-08:00",

   "DispatchDateTime":"2011-03-17T11:04:20-08:00",

   "EntryDateTime":"2011-03-17T11:04:10-08:00",

   "WorkstationID":"Disp-3",

   "Unit":[

           {

               "UnitDispatchNumber":"10009087",

               "UnitID":"E31",

               "PulsePointDispatchStatus":"DP",

               "UnitDispatchDateTime":"2011-03-17T11:04:20-08:00"

           },

           {

               "UnitDispatchNumber":"10009042",

               "UnitID":"E33",

               "PulsePointDispatchStatus":"OS",

               "UnitOnSceneDateTime":"2011-03-17T11:11:54-08:00"

           },

           {

               "UnitDispatchNumber":"10006733",

               "UnitID":"T34",

               "PulsePointDispatchStatus":"ER",

               "UnitEnrouteDateTime":"2011-03-17T11:05:22-08:00"

           }

         ]

}

A request does not need to include all parameters and subsequent requests can continually update and append the incident information. However, all requests must contain AgencyID, TransactionID and IncidentNumber at a minimum.

{

    "AgencyID":"07035",

    "TransactionID":"50000191",

    "IncidentNumber":"1100091597",

    "PulsePointDeterminantCode":"09E02"

}

If provided, Unit resource data must include UnitID and UnitDispatchNumber parameters at a minimum in addition to AgencyID, TransactionID and IncidentNumber.

{

    "AgencyID":"07035",

    "TransactionID":"50000191",

    "IncidentNumber":"1100091597",

    "Unit":[{

            "UnitDispatchNumber":"10009087",

            "UnitID":"E31",

            "PulsePointDispatchStatus":"DP",

            "UnitDispatchDateTime":"2011-03-17T11:04:20-08:00"

        },

        {

            "UnitDispatchNumber":"10009042",

            "UnitID":"E33",

            "PulsePointDispatchStatus":"OS",

            "UnitOnSceneDateTime":"2011-03-17T11:11:54-08:00"

        },

        {

            "UnitDispatchNumber":"10006733",

            "UnitID":"T34",

            "PulsePointDispatchStatus":"ER",

            "UnitEnrouteDateTime":"2011-03-17T11:05:22-08:00"

        }

    ]

}

Sample Responses

Response Format

{

    "StatusCode":"400",

    "StatusDescription":" IncidentNumber missing. All requests must contain AgencyID, TransactionID and IncidentNumber."

}

Incident/Call Types

All incident/call types are normalized into these standard types.

Incident Call Type Description

Pulse Point Incident Call Type

Aid

 

Auto Aid

AA

Mutual Aid

MU

Strike Team

ST

Aircraft

 

Aircraft Emergency

AE

Aircraft Emergency Standby

AES

Aircraft Crash

AC

Landing Zone

LZ

Alarm

 

Alarm

OA

Fire Alarm

FA

Smoke Detector

SD

Waterflow Alarm

WFA

Manual Alarm

MA

Carbon Monoxide

CMA

AED Alarm

AED

Trouble Alarm

TRBL

Assist

 

Flooding          

FL

Ladder Request

LR

Lift Assist

LA

Public Service

PS

Police Assist

PA

Sheared Hydrant

SH

Explosion

 

Explosion        

EX

Pipeline Emergency

PE

Transformer Explosion

TE

Fire

 

Structure Fire

SF

(Triggers alert in PulsePoint App)

Vegetation Fire

VEG

(Triggers alert in PulsePoint App)

Confirmed Structure Fire

WSF

(Triggers alert in PulsePoint App)

Confirmed Vegetation Fire

WVEG

(Triggers alert in PulsePoint App)

Commercial Fire

CF

(Triggers alert in PulsePoint App)

Residential Fire

RF

(Triggers alert in PulsePoint App)

Working Commercial Fire

WCF

(Triggers alert in PulsePoint App)

Working Residential Fire

WRF

(Triggers alert in PulsePoint App)

Vehicle Fire

VF

Extinguished Fire

EF

Illegal Fire

IF

Marine Fire

MF

Outside Fire

OF

Pole Fire

PF

Refuse/Garbage Fire

GF

Full Assignment

FULL

Appliance Fire

AF

Chimney Fire

CHIM

Controlled Burn / Prescribed Fire

CB

Electrical Fire

ELF

Fire

FIRE

Hazard

 

Gas Main

GAS

Hazardous Condition

HC

Bomb Threat

BT

Hazmat Response

HMR

(Triggers alert in PulsePoint App)

Tree Down

TD

Electrical Emergency

EE

Emergency

EM

Emergency Response

ER

Water Emergency

WE

Investigation

 

Investigation

INV

Hazmat Investigation

HMI

Odor Investigation

OI

Smoke Investigation

SI

Arson Investigation

AI

Lockout

 

Lockout            

LO

Commercial Lockout

CL

Residential Lockout

RL

Vehicle Lockout

VL

Medical

 

Medical Emergency

ME

(Triggers a CPR alert for eligible responders only in conjunction with determinant codes identified in ‘Medical Priority Dispatch Codes’ section below)

Interfacility Transfer

IFT

Multi Casualty

MCI

Natural

 

Flood Warning

FLW

Tornado Warning

TOW

Tsunami Warning

TSW

Earthquake

EQ

Other/Non-Emergency

 

Community Activity

CA

Fire Watch

FW

Training

TRNG

Test

TEST

Notification

NO

Standby

STBY

Rescue

 

Rescue

RES

Cliff Rescue

CR

Confined Space

CSR

Rope Rescue

RR

Technical Rescue

TR

(Triggers alert in PulsePoint App)

Trench Rescue

TNR

Water Rescue

WR

(Triggers alert in PulsePoint App)

Animal Rescue

AR

Elevator Rescue

ELR

Urban Search and Rescue

USAR

Vessel Sinking

VS

Vehicle

 

Expanded Traffic Collision

TCE

(Triggers alert in PulsePoint App)

Traffic Collision

TC

(Triggers alert in PulsePoint App)

Traffic Collision Involving Train

TCT

Railroad/Train Emergency

RTE

Traffic Collision Involving Structure

TCS

Wires

 

Wires Arcing

WA

Wires Down

WD

Medical Priority Dispatch Codes

Determinant Descriptor

PulsePoint Determinant Code

Non-MPDS SCA Determinant

Generic Sudden Cardiac Arrest

(use this code to trigger CPR alert if your agency does not use MPDS protocol)

SCA

(used by App for CPR Notifications)

1. Abdominal Pain / Problems

 

Abdominal Pain

01A01

Override

01C00

SUSPECTED aortic aneurysm (tearing/ripping pain) => 50

01C01

Known aortic aneurysm

01C02

Fainting or near fainting => 50

01C03

Females with fainting or near fainting 12-50

01C04

Males with pain above navel => 35

01C05

Females with pain above navel => 45

01C06

Override

01D00

Not alert

01D01

2. Allergies / Envenomations

 

No difficulty breathing or swallowing (rash hives or itching may be present)

02A01

Spider bite

02A02

Override

02B00

Unknown status/Other codes not applicable

02B01

Override

02C00

Difficulty breathing or swallowing

02C01

History of severe allergic reaction

02C02

Override

02D00

Not alert

02D01

DIFFICULTY SPEAKING BETWEEN BREATHS

02D02

Swarming ATTACK (bee wasp hornet)

02D03

Snakebite

02D04

Override

02E00

INEFFECTIVE BREATHING

02E01

3. Animal Bites / Attacks

 

NOT DANGEROUS body area

03A01

NON-RECENT (=> 6hrs) injuries (without priority symptoms)

03A02

SUPERFICIAL bites

03A03

Override

03B00

POSSIBLY DANGEROUS body area

03B01

SERIOUS hemorrhage

03B02

Unknown status/Other codes not applicable

03B03

Override

03D00

Unconscious or Arrest

03D01

Not alert

03D02

Chest or Neck injury (with difficulty breathing)

03D03

DANGEROUS body area

03D04

Large animal

03D05

EXOTIC animal

03D06

ATTACK or multiple animals

03D07

4. Assault / Sexual Assault

 

NOT DANGEROUS body area

04A01

NON-RECENT (=> 6hrs) injuries (without priority symptoms)

04A02

Override

04B00

POSSIBLY DANGEROUS body area

04B01

SERIOUS hemorrhage

04B02

Unknown status/Other codes not applicable

04B03

Override

04D00

Unconscious or Arrest

04D01

Not alert

04D02

Chest or Neck injury (with difficulty breathing)

04D03

Multiple victims

04D04

5. Back Pain

 

NON-TRAUMATIC back pain

05A01

NON-RECENT (=> 6hrs) traumatic back pain (without priority symptoms)

05A02

Override

05C00

SUSPECTED aortic aneurysm (tearing/ripping pain) => 50

05C01

Known aortic aneurysm

05C02

Fainting or near fainting => 50

05C03

Override

05D00

Not alert

05D01

6. Breathing Problems

 

Abnormal breathing

06C01

Override

06D00

Not alert

06D01

DIFFICULTY SPEAKING BETWEEN BREATHS

06D02

CHANGING COLOR

06D03

Clammy

06D04

Override

06E00

INEFFECTIVE BREATHING

06E01

7. Burns / Explosion

 

Burns < 18% body area

07A01

Fire alarm (unknown situation)

07A02

Sunburn or MINOR burns (<= hand size)

07A03

Override

07B00

Blast injuries (without priority symptoms)

07B01

Unknown status/Other codes not applicable

07B02

Override

07C00

Building fire with persons reported inside

07C01

Difficulty breathing

07C02

Burns => 18% body area

07C03

SIGNIFICANT FACIAL burns

07C04

Override

07D00

Multiple victims

07D01

Unconscious or Arrest

07D02

Not alert

07D03

DIFFICULTY SPEAKING BETWEEN BREATHS

07D04

8. Carbon Monoxide / Inhaltation / Hazmat

 

Carbon monoxide detector alarm (without priority symptoms)

08O01

Override

08B00

Alert without difficulty breathing

08B01

Override

08C00

Alert with difficulty breathing

08C01

Override

08D00

Unconscious or Arrest

08D01

Not alert

08D02

DIFFICULTY SPEAKING BETWEEN BREATHS

08D03

Multiple victims

08D04

Unknown status/Other codes not applicable

08D05

9. Cardiac or Respiratory Arrest / Death

 

EXPECTED DEATH unquestionable (x through z)

09O01

Override

09B00

OBVIOUS DEATH unquestionable (a through i)

09B01

Override

09D00

INEFFECTIVE BREATHING

09D01
(used by App for CPR Notifications)

OBVIOUS or EXPECTED DEATH questionable

09D02

Override

09E00

Not breathing at all

09E01
(used by App for CPR Notifications)

Breathing uncertain (AGONAL)

09E02
(used by App for CPR Notifications)

Hanging

09E03

Strangulation

09E04

Suffocation

09E05

Underwater

09E06

10. Chest Pain

 

Breathing normally < 35

10A01

Override

10C00

Abnormal breathing

10C01

Heart attack or angina history

10C02

Cocaine

10C03

Breathing normally => 35

10C04

Override

10D00

Not alert

10D01

DIFFICULTY SPEAKING BETWEEN BREATHS

10D02

CHANGING COLOR

10D03

Clammy

10D04

11. Choking

 

Not choking now (can talk or cry is alert and breathing normally)

11A01

Override

11D00

Abnormal breathing (PARTIAL obstruction)

11D01
(used by App for CPR Notifications)

Not alert

11D02
(used by App for CPR Notifications)

Override

11E00

COMPLETE obstruction/INEFFECTIVE BREATHING

11E01
(used by App for CPR Notifications)

12. Convulsions / Seizures

 

Not seizing now and breathing effectively (verified)

12A01

FOCAL seizure (alert)

12A02

Impending seizure (aura)

12A03

Override

12B00

Effective breathing not verified < 35

12B01

Override

12C00

FOCAL seizure (not alert)

12C01

Pregnancy

12C02

Diabetic

12C03

Override

12D00

Not breathing (after Key Questioning)

12D01
(used by App for CPR Notifications)

CONTINUOUS or MULTIPLE seizures

12D02

AGONAL/INEFFECTIVE BREATHING

12D03

Effective breathing not verified => 35

12D04

13. Diabetic Problems

 

Alert and behaving normally

13A01

Override

13C00

Not alert

13C01

Abnormal behavior

13C02

Abnormal breathing

13C03

Override

13D00

Unconscious

13D01

14. Drowning / Diving / Scuba Accident

 

Alert and breathing normally (no injuries and out of water)

14A01

Override

14B00

Alert and breathing normally (injuries or in water)

14B01

Unknown status/Other codes not applicable

14B02

Override

14C00

Alert with abnormal breathing

14C01

Override

14D00

Unconscious or Arrest

14D01
(used by App for CPR Notifications)

Not alert

14D02

DIVING or suspected neck injury

14D03

SCUBA accident

14D04

15. Electrocution / Lightning

 

Alert and breathing normally

15C01

Override

15D00

Unconscious

15D01

Not disconnected from power

15D02

Power not off or hazard present

15D03

EXTREME FALL (=> 30ft/10m)

15D04

LONG FALL

15D05

Not alert

15D06

Abnormal breathing

15D07

Unknown status/Other codes not applicable

15D08

Override

15E00

NOT BREATHING/INEFFECTIVE BREATHING

15E01

16. Eye Problems / Injuries

 

MODERATE eye injuries

16A01

MINOR eye injuries

16A02

MEDICAL eye problems

16A03

Override

16B00

SEVERE eye injuries

16B01

Override

16D00

Not alert

16D01

17. Falls

 

NOT DANGEROUS body area

17A01

NON-RECENT (=> 6hrs) injuries (without priority symptoms)

17A02

PUBLIC ASSIST (no injuries and no priority symptoms)

17A03

Override

17B00

POSSIBLY DANGEROUS body area

17B01

SERIOUS hemorrhage

17B02

Unknown status/Other codes not applicable

17B03

Override

17D00

EXTREME FALL (=> 30ft/10m)

17D01

Unconscious or Arrest

17D02

Not alert

17D03

Chest or Neck injury (with difficulty breathing)

17D04

LONG FALL

17D05

18. Headache

 

Breathing normally

18A01

Override

18B00

Unknown status/Other codes not applicable

18B01

Override

18C00

Not alert

18C01

Abnormal breathing

18C02

Speech problems

18C03

Sudden onset of severe pain

18C04

Numbness

18C05

Paralysis

18C06

Change in behavior (<= 3hrs)

18C07

19. Heart Problems / A.I.C.D.

 

Heart rate => 50 bpm and < 130 bpm (without priority symptoms)

19A01

Chest pain < 35 (without priority symptoms)

19A02

Override

19C00

Firing of A.I.C.D.

19C01

Abnormal breathing

19C02

Chest pain => 35

19C03

Cardiac history

19C04

Cocaine

19C05

Heart rate < 50 bpm or => 130 bpm (without priority symptoms)

19C06

Unknown status/Other codes not applicable

19C07

Override

19D00

Not alert

19D01

DIFFICULTY SPEAKING BETWEEN BREATHS

19D02

CHANGING COLOR

19D03

Clammy

19D04

Just resuscitated and/or defibrillated (external)

19D05

20. Heat / Cold Exposure

 

Alert

20A01

Override

20B00

Change in skin color

20B01

Unknown status/Other codes not applicable

20B02

Override

20C00

Heart attack or angina history

20C01

Override

20D00

Not alert

20D01

Multiple victims (with priority symptoms)

20D02

21. Hemorrhage / Lacerations

 

NOT DANGEROUS hemorrhage

21A01

MINOR hemorrhage

21A02

Override

21B00

POSSIBLY DANGEROUS hemorrhage

21B01

SERIOUS hemorrhage

21B02

Bleeding disorder

21B03

Blood thinners

21B04

Override

21C00

Hemorrhage through TUBES

21C01

Hemorrhage of dialysis fistula

21C02

Override

21D00

Unconscious or Arrest

21D01

Not alert

21D02

DANGEROUS hemorrhage

21D03

Abnormal breathing

21D04

22. Inaccessible Incident / Other Entrapments (Non-Vehicle)

 

No longer trapped (no injuries)

22A01

Override

22B00

No longer trapped (unknown injuries)

22B01

PERIPHERAL ENTRAPMENT only

22B02

Unknown status (investigation)/Other codes not applicable

22B03

Override

22D00

Mechanical/Machinery ENTRAPMENT

22D01

Trench collapse

22D02

Structure collapse

22D03

Confined space ENTRAPMENT

22D04

Inaccessible terrain situation

22D05

Mudslide/Avalanche

22D06

23. Overdose / Poisoning (Ingestion)

 

POISONING (without priority symptoms)

23O01

Override

23B00

OVERDOSE (without priority symptoms)

23B01

Override

23C00

Not alert

23C01

Abnormal breathing

23C02

Antidepressants (tricyclic)

23C03

Cocaine methamphetamine (or derivatives)

23C04

Narcotics (heroin)

23C05

Acid or alkali (lye)

23C06

Unknown status/Other codes not applicable

23C07

Poison Control request for response

23C08

Override

23D00

Unconscious

23D01

CHANGING COLOR

23D02

24. Pregnancy / Childbirth / Miscarriage

 

Waters broken (no contractions or presenting parts)

24O01

Override

24A00

1st TRIMESTER hemorrhage or MISCARRIAGE

24A01

Override

24B00

Labor (delivery not imminent => 5 months/20 weeks)

24B01

Unknown status/Other codes not applicable

24B02

Override

24C00

2nd TRIMESTER hemorrhage or MISCARRIAGE

24C01

1st TRIMESTER SERIOUS hemorrhage

24C02

Baby born (no complications)

24C03

Override

24D00

BREECH or CORD

24D01

Head visible/out

24D02

IMMINENT delivery (=> 5 months/20 weeks)

24D03

3rd TRIMESTER hemorrhage

24D04

HIGH RISK complications

24D05

Baby born (complications with baby)

24D06

Baby born (complications with mother)

24D07

25. Psychiatric / Abnormal Behavior / Suicide Attempt

 

Non-suicidal and alert

25A01

Suicidal (not threatening) and alert

25A02

Override

25B00

SERIOUS hemorrhage

25B01

Non-SERIOUS or MINOR hemorrhage

25B02

THREATENING SUICIDE

25B03

Jumper (threatening)

25B04

Near hanging strangulation or suffocation (alert)

25B05

Unknown status/Other codes not applicable

25B06

Override

25D00

Not alert

25D01

DANGEROUS hemorrhage

25D02

26. Sick Person

 

Boils

26O02

Bumps (non-traumatic)

26O03

Can't sleep

26O04

Can't urinate (without abdominal pain)

26O05

Catheter (in/out without hemorrhaging)

26O06

Constipation

26O07

Cramps/spasms/joint pain (in extremities and non-traumatic)

26O08

Cut-off ring request

26O09

Deafness

26O10

Defecation/diarrhea

26O11

Earache

26O12

Enema

26O13

Gout

26O14

Hemorrhoids/piles

26O15

Hepatitis

26O16

Hiccups

26O17

Itching

26O18

Nervous

26O19

Object stuck (nose ear vagina rectum penis)

26O20

Object swallowed (without choking or difficulty breathing can talk)

26O21

Painful urination

26O22

Penis problems/pain

26O23

Rash/skin disorder (without difficulty breathing or swallowing)

26O24

Sexually transmitted disease (STD)

26O25

Sore throat (without difficulty breathing or swallowing)

26O26

Toothache (without jaw pain)

26O27

Wound infected (focal or surface)

26O28

Override

26A00

No priority symptoms (complaint conditions 2-11 not identified)

26A01

Blood pressure abnormality (asymptomatic)

26A02

Dizziness/vertigo

26A03

Fever/chills

26A04

General weakness

26A05

Nausea

26A06

New onset of immobility

26A07

Other pain

26A08

Transportation only

26A09

Unwell/ill

26A10

Vomiting

26A11

Override

26B00

Unknown status/Other codes not applicable

26B01

Override

26C00

ALTERED LEVEL OF CONSCIOUSNESS

26C01

Abnormal breathing

26C02

Sickle cell crisis/Thalassemia

26C03

Override

26D00

Not alert

26D01

27. Stab / Gunshot / Penetrating Trauma

 

NON-RECENT (=> 6hrs) PERIPHERAL wounds (without priority symptoms)

27A01

Override

27B00

NON-RECENT (=> 6hrs) single CENTRAL wound

27B01

Known single PERIPHERAL wound

27B02

SERIOUS hemorrhage

27B03

Unknown status/Other codes not applicable

27B04

OBVIOUS DEATH (explosive GSW to head)

27B05

Override

27D00

Unconscious or Arrest

27D01

Not alert

27D02

CENTRAL wounds

27D03

Multiple wounds

27D04

Multiple victims

27D05

28. Stroke  (CVA)

 

Breathing normally < 35

28A01

Override

28C00

Not alert

28C01

Abnormal breathing

28C02

Sudden speech problems

28C03

Sudden weakness or numbness (one side)

28C04

Sudden paralysis or facial droop (one side)

28C05

Sudden loss of balance or coordination

28C06

Sudden vision problems

28C07

Sudden onset of severe headache

28C08

STROKE history

28C09

Breathing normally => 35

28C10

Unknown status/Other codes not applicable

28C11

29. Traffic / Transportation Accidents

 

No injuries (confirmed)

29O01

Override

29A00

1st party caller with injury to NOT DANGEROUS body area

29A01

Override

29B00

Injuries

29B01

SERIOUS hemorrhage

29B02

Other hazards

29B03

Unknown status/Other codes not applicable

29B04

Override

29D00

MAJOR INCIDENT (a through f)

29D01

HIGH MECHANISM (k through s)

29D02

HAZMAT

29D03

Pinned (trapped) victim

29D04

Not alert

29D05

30. Traumatic Injuries

 

NOT DANGEROUS body area

30A01

NON-RECENT (=> 6hrs) injuries (without priority symptoms)

30A02

Override

30B00

POSSIBLY DANGEROUS body area

30B01

SERIOUS hemorrhage

30B02

Override

30D00

Unconscious or Arrest

30D01

Not alert

30D02

Chest or Neck injury (with difficulty breathing)

30D03

31. Unconscious / Fainting

 

Fainting episode(s) and alert => 35 (without cardiac history)

31A01

Fainting episode(s) and alert < 35 (with cardiac history)

31A02

Fainting episode(s) and alert < 35 (without cardiac history)

31A03

Override

31C00

Alert with abnormal breathing

31C01

Fainting episode(s) and alert => 35 (with cardiac history)

31C02

Females 12-50 with abdominal pain

31C03

Override

31D00

Unconscious -- AGONAL/INEFFECTIVE BREATHING

31D01

Unconscious -- Effective breathing

31D02

Not alert

31D03

CHANGING COLOR

31D04

Override

31E00

INEFFECTIVE BREATHING

31E01

32. Unknown Problem

 

Standing sitting moving or talking

32B01

Medical Alarm (Alert) notifications (no patient information)

32B02

Unknown status/Other codes not applicable

32B03

Caller's language not understood (no interpreter in center)

32B04

Override

32D00

LIFE STATUS QUESTIONABLE

32D01

33. Transfer / Interfacility / Palliative Care

 

ACUITY I (no priority symptoms)

33A01

ACUITY II (no priority symptoms)

33A02

ACUITY III (no priority symptoms)

33A03

Override

33C00

Not alert (acute change)

33C01

Abnormal breathing (acute onset)

33C02

Significant hemorrhage or shock

33C03

Possible acute heart problems or MI (heart attack)

33C04

Acute severe pain

33C05

Emergency response requested

33C06

Override

33D00

Suspected cardiac or respiratory arrest

33D01

Just resuscitated and/or defibrillated (external)

33D02

34. ACN (Automatic Crash Notification)

 

No injuries (refer to Police)

34O01

Override

34A00

NOT DANGEROUS injuries (1st party & single occupant)

34A01

Override

34B00

Injuries involved

34B01

Multiple victims (one unit)

34B02

Multiple victims (additional units)

34B03

Airbag/Other Automatic Sensor (no voice)

34B04

Unknown situation/Other codes not applicable

34B05

Override

34D00

HIGH MECHANISM (h through n)

34D01

Unconscious or Not alert

34D02

NOT BREATHING/INEFFECTIVE BREATHING

34D03

LIFE STATUS QUESTIONABLE

34D04

36. Pandemic Flu

 

Chest pain < 35 with single flu symptom

36A01

Chest pain < 35 with multiple flu symptoms

36A02

Flu symptoms only (cough fever chills or sweats sore throat diarrhea unusual total body aches headache etc.)

36A03

Override

36C00

Abnormal breathing with single flu symptom or Asthma/COPD

36C01

Abnormal breathing with multiple flu symptoms

36C02

Chest pain >= 35 with single flu symptom

36C03

Chest pain >= 35 with multiple flu symptoms

36C04

HIGH RISK conditions

36C05

Override

36D00

INEFFECTIVE BREATHING with flu symptoms

36D01

DIFFICULTY SPEAKING BETWEEN BREATHS with flu symptoms

36D02

Not alert with flu symptoms

36D03

CHANGING COLOR with flu symptoms

36D04

37. Interfacility Evaluation / Transfer

 

EVALUATION

37A01

TRANSFER level I

37A02

TRANSFER level II

37A03

TRANSFER level III

37A04

Override

37B00

EVALUATION

37B01

TRANSFER

37B02

Override

37C00

Acute onset of priority symptom(s)

37C01

Suspected acute heart problems or MI (heart attack)

37C02

Suspected STROKE (<= X hours)

37C03

Medication management required

37C04

Emergency response requested

37C05

EVALUATION

37C06

TRANSFER level I

37C07

TRANSFER level II

37C08

TRANSFER level III

37C09

Override

37D00

NOT BREATHING/INEFFECTIVE BREATHING

37D01

EVALUATION

37D02

TRANSFER

37D03


Unit Dispatch Status Codes

Status Code Descriptor

PulsePoint Dispatch Status Code

Dispatched

DP

Acknowledged

AK

Enroute

ER

Onscene

OS

Transport

TR

Transport Arrived

TA

Available in Quarters

AQ

Available on Radio

AR

Available Onscene

AE