---
title: "Retrieving Events"
method: GET
path: "/cad/events"
tags: ["CAD Events"]
---

# Retrieving Events

`GET /cad/events`

Gets events in chronological order of when they were created (most recent first)

## Query parameters

- `start` string, date-time, required — RFC3339 UTC datetime string
- `end` string, date-time — RFC3339 UTC datetime string
- `pageSize` integer
- `page` integer
- `activeOnly` boolean

## Response `200`

Success

- EventsResponse
  - `events` Event[]
    - `externalId` string, required — external id of event used for identification
    - `groupingId` string — optional id used to link multiple events together
    - `displayId` string — optional override of external id to be displayed in UI
    - `eventType` string, required
    - `priority` integer, required — 1-indexed value representing priority of the event (lower is higher priority)
    - `displayPriority` string — optional override of priority value to be displayed in UI
    - `timestamp` string, date-time — RFC3339 UTC datetime string of when event started (defaults to current time if not provided)
    - `closedAt` string, date-time — RFC3339 UTC datetime string of when event ended (event considered open if not set)
    - `displayStatus` string — optional custom status of event to be displayed in UI
    - `department` string — optional field for specifying department involved (fire, EMS, etc.)
    - `area` string — optional field for specifying district/sector/beat involved in event
    - `narratives` string[]
    - `location` Location — either latitude and longitude is required, or one of streetAddress/city/state
      - `name` string — commmon name to identify location by
      - `latitude` number
      - `longitude` number
      - `streetAddress` string
      - `city` string
      - `state` string
      - `country` string
      - `additionalMetadata` AdditionalMetadata — flat json object, defaults to {} and returned as {} if not provided
        - `type` 'string' | 'number' | 'boolean' — What type the value of the metadata value is
        - `value` object — value of the metadata. Must be a string, number, or boolean
    - `callerInfo` CallerInfo
      - `name` string
      - `phoneNumber` string
      - `timestamp` string, date-time — RFC3339 UTC datetime string
      - `location` Location — either latitude and longitude is required, or one of streetAddress/city/state
        - `name` string — commmon name to identify location by
        - `latitude` number
        - `longitude` number
        - `streetAddress` string
        - `city` string
        - `state` string
        - `country` string
        - `additionalMetadata` AdditionalMetadata — flat json object, defaults to {} and returned as {} if not provided
          - `type` 'string' | 'number' | 'boolean' — What type the value of the metadata value is
          - `value` object — value of the metadata. Must be a string, number, or boolean
      - `additionalMetadata` AdditionalMetadata — flat json object, defaults to {} and returned as {} if not provided
        - `type` 'string' | 'number' | 'boolean' — What type the value of the metadata value is
        - `value` object — value of the metadata. Must be a string, number, or boolean
    - `dispatchedUnits` DispatchedUnit[]
      - `id` string, required
      - `displayId` string — optional override of unit id to be displayed in UI
      - `dispatchTime` string, date-time, required — RFC3339 UTC datetime string
      - `arrivalTime` string, date-time — RFC3339 UTC datetime string
      - `additionalMetadata` AdditionalMetadata — flat json object, defaults to {} and returned as {} if not provided
        - `type` 'string' | 'number' | 'boolean' — What type the value of the metadata value is
        - `value` object — value of the metadata. Must be a string, number, or boolean
    - `involvedVehicles` InvolvedVehicle[]
      - `color` string
      - `make` string
      - `model` string
      - `year` integer
      - `plateNumber` string
      - `plateState` string
      - `additionalMetadata` AdditionalMetadata — flat json object, defaults to {} and returned as {} if not provided
        - `type` 'string' | 'number' | 'boolean' — What type the value of the metadata value is
        - `value` object — value of the metadata. Must be a string, number, or boolean
    - `involvedPersons` InvolvedPerson[]
      - `name` string
      - `externalId` string — unique identifier for person, generated if not provided
      - `description` string
      - `dateOfBirth` string, date
      - `email` string
      - `secondaryEmail` string
      - `phone` string
      - `secondaryPhone` string
      - `streetAddress` string
      - `secondaryStreetAddress` string
      - `ethnicity` string
      - `eyeColor` string
      - `hairColor` string
      - `height` string
      - `age` integer
      - `gender` string
      - `additionalMetadata` AdditionalMetadata — flat json object, defaults to {} and returned as {} if not provided
        - `type` 'string' | 'number' | 'boolean' — What type the value of the metadata value is
        - `value` object — value of the metadata. Must be a string, number, or boolean
    - `additionalMetadata` AdditionalMetadata — flat json object, defaults to {} and returned as {} if not provided
      - `type` 'string' | 'number' | 'boolean' — What type the value of the metadata value is
      - `value` object — value of the metadata. Must be a string, number, or boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/flocksafety/apis/oauth-api.md) · [All operations](https://skmtc.net/flocksafety/apis/oauth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flocksafety/oauth-api/revisions/126df7964ba5/schema)