Lytx Safety (DriveCam) API

Legacy API to retrieve vehicles events data. Uses obsolete X-APIKey authentication.

Operations 9

GET /safety/events Return Accessible Events IDs #
GET /safety/events/{id} Return Specified Event #
GET /safety/events/{eventId}/file Return Event File for Specified Event in Specified File Format #
GET /safety/events/statuses Return List of Possible Event Statuses #
GET /safety/events/triggers Return List of Possible Event Triggers #
GET /safety/events/triggersubtypes Return List of Possible Event Trigger Subtypes #
GET /safety/events/behaviors Return List of Possible Event Behaviors #
GET /safety/events/dynamicRisks Return List of Possible Dynamic Risks #
GET /safety/eventsWithMetadata Return Accessible Events with Metadata #

Documentation

📖
Documentation
https://developer.lytx.com/openapispec/consent.openapi
📖
APIReference
https://developer.lytx.com/openapispec/consent.openapi
📖
Documentation
https://developer.lytx.com/openapispec/device.openapi
📖
APIReference
https://developer.lytx.com/openapispec/device.openapi
📖
Documentation
https://developer.lytx.com/openapispec/deviceplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/deviceplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/devicestatusinfoplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/devicestatusinfoplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/diagnosticsplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/diagnosticsplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/distance.openapi
📖
APIReference
https://developer.lytx.com/openapispec/distance.openapi
📖
Documentation
https://developer.lytx.com/openapispec/driver.assignment.openapi
📖
APIReference
https://developer.lytx.com/openapispec/driver.assignment.openapi
📖
Documentation
https://developer.lytx.com/openapispec/driversplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/driversplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/dvir.openapi
📖
APIReference
https://developer.lytx.com/openapispec/dvir.openapi
📖
Documentation
https://developer.lytx.com/openapispec/dvirplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/dvirplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/ecm.openapi
📖
APIReference
https://developer.lytx.com/openapispec/ecm.openapi
📖
Documentation
https://developer.lytx.com/openapispec/ecm.v2.openapi
📖
APIReference
https://developer.lytx.com/openapispec/ecm.v2.openapi
📖
Documentation
https://developer.lytx.com/openapispec/exceptioneventplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/exceptioneventplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/faultdataplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/faultdataplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/fleetutilizationplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/fleetutilizationplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/geofences.openapi
📖
APIReference
https://developer.lytx.com/openapispec/geofences.openapi
📖
Documentation
https://developer.lytx.com/openapispec/gps.openapi
📖
APIReference
https://developer.lytx.com/openapispec/gps.openapi
📖
Documentation
https://developer.lytx.com/openapispec/gpsplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/gpsplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/group.openapi
📖
APIReference
https://developer.lytx.com/openapispec/group.openapi
📖
Documentation
https://developer.lytx.com/openapispec/group.v2.openapi
📖
APIReference
https://developer.lytx.com/openapispec/group.v2.openapi
📖
Documentation
https://developer.lytx.com/openapispec/groupplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/groupplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/hos.openapi
📖
APIReference
https://developer.lytx.com/openapispec/hos.openapi
📖
Documentation
https://developer.lytx.com/openapispec/hosplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/hosplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/iftareportplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/iftareportplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/legacy.driversession.services.openapi
📖
APIReference
https://developer.lytx.com/openapispec/legacy.driversession.services.openapi
📖
Documentation
https://developer.lytx.com/openapispec/legacy.groups.openapi
📖
APIReference
https://developer.lytx.com/openapispec/legacy.groups.openapi
📖
Documentation
https://developer.lytx.com/openapispec/legacy.hos.openapi
📖
APIReference
https://developer.lytx.com/openapispec/legacy.hos.openapi
📖
Documentation
https://developer.lytx.com/openapispec/legacy.vehicleinfo.aggregator.openapi
📖
APIReference
https://developer.lytx.com/openapispec/legacy.vehicleinfo.aggregator.openapi
📖
Documentation
https://developer.lytx.com/openapispec/legacy.vehicles.openapi
📖
APIReference
https://developer.lytx.com/openapispec/legacy.vehicles.openapi
📖
Documentation
https://developer.lytx.com/openapispec/legacy.videoplatform.openapi
📖
APIReference
https://developer.lytx.com/openapispec/legacy.videoplatform.openapi
📖
Documentation
https://developer.lytx.com/openapispec/maintenancerecordsplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/maintenancerecordsplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/ruleplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/ruleplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/safety.openapi
📖
APIReference
https://developer.lytx.com/openapispec/safety.openapi
📖
Documentation
https://developer.lytx.com/openapispec/statusdataplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/statusdataplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/trips.openapi
📖
APIReference
https://developer.lytx.com/openapispec/trips.openapi
📖
Documentation
https://developer.lytx.com/openapispec/tripsplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/tripsplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/user.openapi
📖
APIReference
https://developer.lytx.com/openapispec/user.openapi
📖
Documentation
https://developer.lytx.com/openapispec/userplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/userplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/vehicles.openapi
📖
APIReference
https://developer.lytx.com/openapispec/vehicles.openapi
📖
Documentation
https://developer.lytx.com/openapispec/video.openapi
📖
APIReference
https://developer.lytx.com/openapispec/video.openapi
📖
Documentation
https://developer.lytx.com/openapispec/zonesplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/zonesplus.openapi
📖
Documentation
https://developer.lytx.com/openapispec/zonesputandpostplus.openapi
📖
APIReference
https://developer.lytx.com/openapispec/zonesputandpostplus.openapi

Specifications

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/lytx-safety-drivecam-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

lytx-safety-drivecam-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: VIDEO Safety (DriveCam) API
  version: 1.0.0
  description: Legacy API to retrieve vehicles events data. Uses obsolete X-APIKey authentication.
servers:
- url: https://lytx-api.prod2.ph.lytx.com/video
- url: https://lytx-api.prod5.ph.lytx.com/video
- url: https://lytx-api.prod6.lv.lytx.com/video
- url: https://lytx-api.prod7.lv.lytx.com/video
- url: https://lytx-api.prod8.lv.lytx.com/video
security:
- APIKey: []
tags:
- name: Safety (DriveCam)
  description: Legacy API to retrieve vehicles events data. Uses obsolete X-APIKey authentication.
paths:
  /safety/events:
    get:
      tags:
      - Safety (DriveCam)
      summary: Return Accessible Events IDs
      operationId: Events_GetEvents
      parameters:
      - name: from
        in: query
        description: 'Start of a time range supplied in dateOption parameter. If not provided the latest events will be retrieved. Format must be compliant with ISO8601 and expressed in UTC format. (Example: 2021-03-16T16:19:58.80Z).'
        schema:
          type:
          - string
          - 'null'
          pattern: \d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d:[0-5]\d\.\d+([+-][0-2]\d:[0-5]\d|Z)
        x-position: 1
      - name: to
        in: query
        description: 'End of a time range supplied in dateOption parameter. If not provided the latest events will be retrieved. Format must be compliant with ISO8601 and expressed in UTC format. (Example: 2021-03-16T16:19:58.80Z).'
        schema:
          type:
          - string
          - 'null'
          pattern: \d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d:[0-5]\d\.\d+([+-][0-2]\d:[0-5]\d|Z)
        x-position: 2
      - name: dateOption
        in: query
        description: Date range option (lastUpdatedDate, recordDate). By default service will return the latest events.
        schema:
          type:
          - string
          - 'null'
          default: lastUpdatedDate
        x-position: 3
      - name: groupId
        in: query
        description: Id of the group of the events of interest. If the group does not exist or is not visible to the user due to security then no results will be returned. If not supplied, then events in all groups accessible to the group of encompassed access key will be returned (GUID).
        schema:
          type:
          - string
          - 'null'
          pattern: ^[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}$
        x-position: 4
      - name: triggers
        in: query
        style: form
        explode: true
        description: Ids of triggers of events to be filtered.
        schema:
          type:
          - array
          - 'null'
          items:
            type: integer
        x-position: 5
      - name: statuses
        in: query
        style: form
        explode: true
        description: Ids of statuses of events to be filtered.
        schema:
          type:
          - array
          - 'null'
          items:
            type: integer
        x-position: 6
      - name: behaviors
        in: query
        style: form
        explode: true
        description: Ids of behaviors of events to be filtered.
        schema:
          type:
          - array
          - 'null'
          items:
            type: integer
        x-position: 7
      - name: driverId
        in: query
        description: Id of a driver associated to the event (GUID).
        schema:
          type:
          - string
          - 'null'
          pattern: ^[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}$
        x-position: 8
      - name: vehicleId
        in: query
        description: Id of a vehicle associated to the event (GUID).
        schema:
          type:
          - string
          - 'null'
          pattern: ^[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}$
        x-position: 9
      - name: deviceId
        in: query
        description: Id of a device associated to the event.
        schema:
          type:
          - string
          - 'null'
          maxLength: 50
          minLength: 0
        x-position: 10
      - name: sortDirection
        in: query
        description: Type of sorting direction (asc or desc). By default the service will return items in descending order.
        schema:
          type:
          - string
          - 'null'
          default: desc
        x-position: 11
      - name: sortBy
        in: query
        description: A value to sort by (lastUpdatedDate, recordDate). By deafult the service will return items sorted by last updated date.
        schema:
          type:
          - string
          - 'null'
          default: lastUpdatedDate
        x-position: 12
      - name: includeSubgroups
        in: query
        description: Indicates whether results should include data for all subgroups of the group specified. Default to true.
        schema:
          type: boolean
          default: true
        x-position: 13
      - name: limit
        in: query
        description: 'Indicates count of items to retrieve. By default the service will return 1000 items. Range: [1, 1000]'
        schema:
          type: integer
          format: int32
          default: 1000
          maximum: 1000
          minimum: 1
        x-position: 14
      - name: page
        in: query
        description: "Number of the page of event records to be returned.\n            If not provided, first page of records will be returned."
        schema:
          type: integer
          format: int32
          maximum: 2147483647
          minimum: 1
        x-position: 15
      responses:
        '200':
          description: Events retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SafetyEvents'
        '204':
          description: No events were found that match the specified selection criteria.
        '400':
          description: The parameters given in the request are invalid.
        '401':
          description: Unauthorized due to providing an invalid access key, or invalid pod.
        '403':
          description: Access is forbidden. The given API access-key does not have the required permissions.
        '500':
          description: Internal server error
        '503':
          description: Database is unavailable.
  /safety/events/{id}:
    get:
      tags:
      - Safety (DriveCam)
      summary: Return Specified Event
      operationId: Events_GetEventById
      parameters:
      - name: id
        in: path
        required: true
        description: ID or Customer specific ID of the event of interest. The parameter depends on idOption parameter
        schema:
          type:
          - string
          - 'null'
        x-position: 1
      - name: includeSubgroups
        in: query
        description: Indicates whether results should include data for all subgroups of the group specified. Defaults to true
        schema:
          type: boolean
          default: true
        x-position: 2
      - name: idOption
        in: query
        description: Indicates whether event should be returned by ID of event (id) or customer id (cid). By default the service will search by event id.
        schema:
          type:
          - string
          - 'null'
          default: id
        x-position: 3
      responses:
        '200':
          description: Event retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SafetyEvent'
        '400':
          description: The parameters given in the request are invalid.
        '401':
          description: Unauthorized due to providing an invalid access key, or invalid pod.
        '403':
          description: Access is forbidden. The given API access-key does not have the required permissions.
        '404':
          description: Event does not exist.
        '500':
          description: Internal server error
        '503':
          description: Database is unavailable.
  /safety/events/{eventId}/file:
    get:
      tags:
      - Safety (DriveCam)
      summary: Return Event File for Specified Event in Specified File Format
      operationId: Events_GetEventFile
      parameters:
      - name: eventId
        in: path
        required: true
        description: Id of the event of interest.
        schema:
          type:
          - string
          - 'null'
          pattern: ^[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}$
        x-position: 1
      - name: format
        in: query
        required: true
        description: Format of the wanted file (dce or mp4).
        schema:
          type:
          - string
          - 'null'
        x-position: 2
      responses:
        '200':
          description: File retrieved.
          content:
            application/octet-stream:
              schema:
                type: string
                format: byte
            video/mp4:
              schema:
                type: string
                format: byte
        '400':
          description: The parameters given in the request are invalid.
        '401':
          description: Unauthorized due to providing an invalid access key, or invalid pod.
        '403':
          description: Access is forbidden. The given API access-key does not have the required permissions. In order to enable video file downloads, contact lytx team.
        '404':
          description: File does not exist.
        '500':
          description: Internal server error
        '503':
          description: Database is unavailable.
  /safety/events/statuses:
    get:
      tags:
      - Safety (DriveCam)
      summary: Return List of Possible Event Statuses
      operationId: Events_GetEventStatuses
      responses:
        '200':
          description: Event statuses retrieved.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SafetyEventStatus'
        '204':
          description: No event statuses found.
        '401':
          description: Unauthorized due to providing an invalid access key, or invalid pod.
        '403':
          description: Access is forbidden. The given API access-key does not have the required permissions.
        '500':
          description: Internal server error
        '503':
          description: Database is unavailable.
  /safety/events/triggers:
    get:
      tags:
      - Safety (DriveCam)
      summary: Return List of Possible Event Triggers
      operationId: Events_GetEventTriggers
      responses:
        '200':
          description: Event triggers retrieved.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SafetyEventTrigger'
        '204':
          description: No event triggers found.
        '401':
          description: Unauthorized due to providing an invalid access key, or invalid pod.
        '403':
          description: Access is forbidden. The given API access-key does not have the required permissions.
        '500':
          description: Internal server error
        '503':
          description: Database is unavailable.
  /safety/events/triggersubtypes:
    get:
      tags:
      - Safety (DriveCam)
      summary: Return List of Possible Event Trigger Subtypes
      operationId: Events_GetEventTriggerSubtype
      responses:
        '200':
          description: Event trigger subtype retrieved.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SafetyEventTriggerSubtype'
        '204':
          description: No event trigger subtype found.
        '401':
          description: Unauthorized due to providing an invalid access key, or invalid pod.
        '403':
          description: Access is forbidden. The given API access-key does not have the required permissions.
        '500':
          description: Internal server error
        '503':
          description: Database is unavailable.
  /safety/events/behaviors:
    get:
      tags:
      - Safety (DriveCam)
      summary: Return List of Possible Event Behaviors
      operationId: Events_GetEventBehaviors
      responses:
        '200':
          description: Event behaviors retrieved.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SafetyEventBehavior'
        '204':
          description: No event behaviors found.
        '401':
          description: Unauthorized due to providing an invalid access key, or invalid pod.
        '403':
          description: Access is forbidden. The given API access-key does not have the required permissions.
        '500':
          description: Internal server error
        '503':
          description: Database is unavailable.
  /safety/events/dynamicRisks:
    get:
      tags:
      - Safety (DriveCam)
      summary: Return List of Possible Dynamic Risks
      operationId: Events_GetDynamicRisk
      responses:
        '200':
          description: Dynamic risks retrieved.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SafetyEventDynamicRisks'
        '204':
          description: No dynamic risks found.
        '401':
          description: Unauthorized due to providing an invalid access key, or invalid pod.
        '403':
          description: Access is forbidden. The given API access-key does not have the required permissions.
        '500':
          description: Internal server error
        '503':
          description: Database is unavailable.
  /safety/eventsWithMetadata:
    get:
      tags:
      - Safety (DriveCam)
      summary: Return Accessible Events with Metadata
      operationId: Events_GetEventsWithMetadata
      parameters:
      - name: from
        in: query
        description: 'Start of a time range supplied in dateOption parameter. If not provided the latest events will be retrieved. Format must be compliant with ISO8601 and expressed in UTC format. (Example: 2021-03-16T16:19:58.80Z).'
        schema:
          type:
          - string
          - 'null'
          pattern: \d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d:[0-5]\d\.\d+([+-][0-2]\d:[0-5]\d|Z)
        x-position: 1
      - name: to
        in: query
        description: 'End of a time range supplied in dateOption parameter. If not provided the latest events will be retrieved. Format must be compliant with ISO8601 and expressed in UTC format. (Example: 2021-03-16T16:19:58.80Z).'
        schema:
          type:
          - string
          - 'null'
          pattern: \d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d:[0-5]\d\.\d+([+-][0-2]\d:[0-5]\d|Z)
        x-position: 2
      - name: dateOption
        in: query
        description: Date range option (lastUpdatedDate, recordDate). By default service will return the latest events.
        schema:
          type:
          - string
          - 'null'
          default: lastUpdatedDate
        x-position: 3
      - name: groupId
        in: query
        description: Id of the group of the events of interest. If the group does not exist or is not visible to the user due to security then no results will be returned. If not supplied, then events in all groups accessible to the group of encompassed access key will be returned (GUID).
        schema:
          type:
          - string
          - 'null'
          pattern: ^[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}$
        x-position: 4
      - name: triggers
        in: query
        style: form
        explode: true
        description: Ids of triggers of events to be filtered.
        schema:
          type:
          - array
          - 'null'
          items:
            type: integer
        x-position: 5
      - name: statuses
        in: query
        style: form
        explode: true
        description: Ids of statuses of events to be filtered.
        schema:
          type:
          - array
          - 'null'
          items:
            type: integer
        x-position: 6
      - name: behaviors
        in: query
        style: form
        explode: true
        description: Ids of behaviors of events to be filtered.
        schema:
          type:
          - array
          - 'null'
          items:
            type: integer
        x-position: 7
      - name: driverId
        in: query
        description: Id of a driver associated to the event (GUID).
        schema:
          type:
          - string
          - 'null'
          pattern: ^[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}$
        x-position: 8
      - name: vehicleId
        in: query
        description: Id of a vehicle associated to the event (GUID).
        schema:
          type:
          - string
          - 'null'
          pattern: ^[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}$
        x-position: 9
      - name: deviceId
        in: query
        description: Id of a device associated to the event.
        schema:
          type:
          - string
          - 'null'
          maxLength: 50
          minLength: 0
        x-position: 10
      - name: sortDirection
        in: query
        description: Type of sorting direction (asc or desc). By default the service will return items in descending order.
        schema:
          type:
          - string
          - 'null'
          default: desc
        x-position: 11
      - name: sortBy
        in: query
        description: A value to sort by (lastUpdatedDate, recordDate). By deafult the service will return items sorted by last updated date.
        schema:
          type:
          - string
          - 'null'
          default: lastUpdatedDate
        x-position: 12
      - name: includeSubgroups
        in: query
        description: Indicates whether results should include data for all subgroups of the group specified. Default to true.
        schema:
          type: boolean
          default: true
        x-position: 13
      - name: limit
        in: query
        description: 'Indicates count of items to retrieve. By default the service will return 1000 items. Range: [1, 1000]'
        schema:
          type: integer
          format: int32
          default: 1000
          maximum: 1000
          minimum: 1
        x-position: 14
      - name: page
        in: query
        description: "Number of the page of event records to be returned.\n            If not provided, first page of records will be returned."
        schema:
          type: integer
          format: int32
          maximum: 2147483647
          minimum: 1
        x-position: 15
      responses:
        '200':
          description: Events retrieved with metadata.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SafetyEvent'
        '204':
          description: No events were found that match the specified selection criteria.
        '400':
          description: The parameters given in the request are invalid.
        '401':
          description: Unauthorized due to providing an invalid access key, or invalid pod.
        '403':
          description: Access is forbidden. The given API access-key does not have the required permissions.
        '500':
          description: Internal server error
        '503':
          description: Database is unavailable.
components:
  schemas:
    SafetyEventTriggerSubtype:
      type: object
      additionalProperties: false
      required:
      - id
      - name
      - creationDate
      properties:
        id:
          type: integer
          description: Unique id of the trigger subtype.
          format: int32
        name:
          type: string
          description: Name of the trigger subtype.
          minLength: 1
        creationDate:
          type: string
          description: Creation date of the trigger subtype.
          format: date-time
          minLength: 1
        revisionDate:
          type:
          - string
          - 'null'
          description: Timestamp of last revision of the object, may be null if event hasn’t changed since it was created.
          format: date-time
    SafetyEventDynamicRisks:
      type: object
      additionalProperties: false
      required:
      - id
      - name
      - creationDate
      properties:
        id:
          type: integer
          description: Unique id of the dynamic risk.
          format: int32
        name:
          type: string
          description: Name of the dynamic risk.
          minLength: 1
        creationDate:
          type: string
          description: Creation date of the dynamic risk.
          format: date-time
          minLength: 1
    SafetyEventBehavior:
      type: object
      additionalProperties: false
      required:
      - id
      - name
      - creationDate
      properties:
        id:
          type: integer
          description: Unique id of the behavior.
          format: int32
        name:
          type: string
          description: Name of the behavior.
          minLength: 1
        creationDate:
          type: string
          description: Creation date of the behavior.
          format: date-time
          minLength: 1
        revisionDate:
          type:
          - string
          - 'null'
          description: Timestamp of last revision of the object, may be null if event hasn’t changed since it was created.
          format: date-time
    SafetyEventTrigger:
      type: object
      additionalProperties: false
      required:
      - id
      - name
      - creationDate
      properties:
        id:
          type: integer
          description: Unique id of the trigger.
          format: int32
        name:
          type: string
          description: Name of the trigger.
          minLength: 1
        creationDate:
          type: string
          description: Creation date of the trigger.
          format: date-time
          minLength: 1
        revisionDate:
          type:
          - string
          - 'null'
          description: Timestamp of last revision of the object, may be null if event hasn’t changed since it was created.
          format: date-time
    Note:
      type: object
      additionalProperties: false
      required:
      - id
      - body
      - creationDate
      - authorUserId
      - firstName
      - lastName
      properties:
        id:
          type: string
          description: Id of note.
          format: guid
          minLength: 1
        body:
          type: string
          description: Content of note.
          minLength: 1
        creationDate:
          type: string
          description: Creation date of note.
          format: date-time
          minLength: 1
        authorUserId:
          type: string
          description: Id of author.
          format: guid
          minLength: 1
        firstName:
          type: string
          description: First name of author.
          minLength: 1
        lastName:
          type: string
          description: Last name of author.
          minLength: 1
    SafetyEvent:
      type: object
      additionalProperties: false
      required:
      - id
      - customerEventId
      - eventTriggerId
      - eventTriggerSubTypeId
      - eventStatusId
      - recordDateUTC
      - recordDateTZ
      - recordDateUTCOffset
      - score
      - erSerialNumber
      - groupId
      - creationDate
      - objectRevision
      properties:
        id:
          type: string
          description: Unique ID for the event in the system.
          format: guid
          minLength: 1
        customerEventId:
          type: string
          description: Unique ID for the event within the customer’s data(not unique across customers).
          minLength: 1
        eventTriggerId:
          type: integer
          description: ID of the event trigger.
        eventTriggerSubTypeId:
          type: integer
          description: ID of the event trigger subtype.
        eventStatusId:
          type: integer
          description: ID of the event status.
        recordDateUTC:
          type: string
          description: Date event was recorded in UTC.
          format: date-time
          minLength: 1
        recordDateTZ:
          type: string
          description: 3-4 letter abbreviation of time zone associated with ER at time event was recorded.
          minLength: 1
        recordDateUTCOffset:
          type: integer
          description: Offset in minutes including sign from UTC time at which event was recorded.
          format: int32
        downloadedDate:
          type:
          - string
          - 'null'
          description: Date event was downloaded from the ER in UTC, may be null.
          format: date-time
        score:
          type: integer
          description: Event’s risk score.
          format: int32
        reviewedDate:
          type:
          - string
          - 'null'
          description: Date event was reviewed in UTC, may be null if event hasn't been reviewed.
          format: date-time
        erSerialNumber:
          type: string
          description: Serial number of the ER that captured the event.
          minLength: 1
        overDue:
          type:
          - number
          - 'null'
          description: Number of days that the event is overdue (forreviewing/coaching), may be null.
          format: decimal
        vehicleId:
          type:
          - string
          - 'null'
          description: ID of the vehicle associated to the ER that captured the event, may be null if no vehicle is associated with the event.
          format: guid
        groupId:
          type: string
          description: ID of the group that the event is associated to.
          format: guid
          minLength: 1
        forwardMax:
          type:
          - number
          - 'null'
          description: Maximum forward g-force that occurred within the event, may be null.
          format: decimal
        lateralMax:
          type:
          - number
          - 'null'
          description: Maximum lateral g-force that occurred within the event, may be null.
          format: decimal
        forwardThreshold:
          type:
          - number
          - 'null'
          description: Forward g-force threshold that ER was configured for at the time event was captured, may be null.
          format: decimal
        lateralThreshold:
          type:
          - number
          - 'null'
          description: Lateral g-force threshold that ER was configured for at the time event was captured, may be null.
          format: decimal
        shockThreshold:
          type:
          - number
          - 'null'
          description: Shock g-force threshold that ER was configured for at the time event was captured, may be null.
          format: decimal
        speed:
          type:
          - number
          - 'null'
          description: Speed at time of trigger in meters per second, may be null if no speed data is available at the trigger.
          format: double
        latitude:
          type:
          - number
          - 'null'
          description: Latitude at time of trigger, may be null if no latitude data is available at the trigger.
          format: decimal
        longitude:
          type:
          - number
          - 'null'
          description: Longitude at time of trigger, may be null if no longitude data is available at the trigger.
          format: decimal
        heading:
          type:
          - number
          - 'null'
          description: Heading (direction) at time of trigger, may be null if no heading data is available at the trigger.
          format: decimal
        driverId:
          type:
          - string
          - 'null'
          description: ID of the driver associated with this event, may be null if no driver is associated with the event.
          format: guid
        coachId:
          type:
          - string
          - 'null'
          description: ID of the coach associated with this event, may be null if no coach is associated with the event.
          format: guid
        coachedDate:
          type:
          - string
          - 'null'
          description: Date when driver associated to the event was coached in UTC, may be null.
          format: date-time
        creationDate:
          type: string
          description: Timestamp when event was created in the system.
          format: date-time
          minLength: 1
        notes:
          type:
          - array
          - 'null'
          description: Notes written up for this event (by reviewer, coach, and/or driver).
          items:
            $ref: '#/components/schemas/Note'
        eventNotes:
          type:
          - array
          - 'null'
          description: EventNotes written up for this event
          items:
            $ref: '#/components/schemas/Note'
        coachingSessionNotes:
          type:
          - array
          - 'null'
          description: CoachingSessionNotes written up for this event
          items:
            $ref: '#/components/schemas/Note'
        reviewNotes:
          type:
          - array
          - 'null'
          description: ReviewNotes written up for this event
          items:
            $ref: '#/components/schemas/Note'
        behaviors:
          type:
          - array
          - 'null'
          description: List of behaviors currently associated with the event,
          items:
            $ref: '#/components/schemas/SafetyEventBehavior'
        dynamicRisks:
          type:
          - array
          - 'null'
          description: List of dynamic risks currently associated with the event,
          items:
            $ref: '#/components/schemas/SafetyEventDynamicRisks'
        objectRevision:
          type: integer
          description: Revision number of the event at time data is retrieved.
          format: int32
        revisionDate:
          type:
          - string
          - 'null'
          description: Timestamp of last revision of the object, may be null if event hasn’t changed since it was created.
          format: date-time
        coachingOverdueDate:
          type:
          - string
          - 'null'
          description: The date when the event becomes overdue for coaching.
          format: date-time
        coachableDate:
          type:
          - string
          - 'null'
          description: The date when the event becomes coachable.
          format: date-time
    SafetyEventStatus:
      type: object
      additionalProperties: false
      required:
      - id
      - name
      - creationDate
      properties:
        id:
          type: integer
          description: Unique id of the status.
          format: int32
        name:
          type: string
          description: Name of the status.
          minLength: 1
        creationDate:
          type: string
          description: Creation date of the status.
          format: date-time
          minLength: 1
        revisionDate:
          type:
          - string
          - 'null'
          description: Timestamp of last revision of the object, may be null if event hasn’t changed since it was created.
          format: date-time
    SafetyEvents:
      type: object
      additionalProperties: false
      required:
      - totalCount
      - eventsIds
      properties:
        totalCount:
          type: integer
          description: Total count of event ids.
          format: int64
        eventsIds:
          type: array
          description: Collection of events IDs.
          items:
            type: string
            format: guid
  securitySchemes:
    APIKey:
      type: apiKey
      description: Enter your API key
      name: X-APIKey
      in: header
x-generator: NSwag v13.8.2.0 (NJsonSchema v10.2.1.0 (Newtonsoft.Json v12.0.0.0))