Skip to content
Safety RadarSafety RadarSafety Radar Docs

List events

GET
/events
curl --request GET \
  --url 'https://safe-api.safetyradar.com/v2/events?limit=50&page=1&dir=asc' \
  --header 'Authorization: Bearer <token>'

Get a paginated list of events with optional filtering

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
limit
Any of:
string
page
Any of:
string
q
string
sort
string
dir
string
Allowed values: asc desc
conditions
Any of:
string
teams
Any of:
Array<string>
updatedAfter
string format: date-time
updatedBefore
string format: date-time
metricData
Any of:
string
unlocated
Any of:
boolean

Responses

Section titled “Responses”

200

Section titled “200”

Paginated list of events

Media typeapplication/json
object
data
required
Array<object>
object
id
required
string format: uuid
organizationId
required
string format: uuid
externalId
required
string
type
required
string
title
required
string
eventDate
required

Event date and time in UTC. Accepts a full ISO 8601 timestamp (e.g. “2026-05-19T14:23:00Z”) or a date-only string (“2026-05-19”); date-only inputs are anchored at 08:00 UTC for backwards compatibility.

string format: date-time
reportDate
required
string
nullable
address1
required
string
nullable
address2
required
string
nullable
city
required
string
nullable
state
required
string
nullable
zip
required
string
nullable
latitude
required
number
nullable >= -140737488355328 <= 140737488355327
longitude
required
number
nullable >= -140737488355328 <= 140737488355327
description
required
string
ownerId
required
string format: uuid
nullable
reportedBy
required
string format: uuid
nullable
locationId
required
string format: uuid
nullable
statusId
required
string format: uuid
nullable
actionTaken
required
string
nullable
metadata
required
object
key
additional properties
nullable
media
required
Array<string>
nullable
metricData
required
object
key
additional properties
nullable
trainingMetadata
required
Array<object>
nullable
object
name
required
string
value
required
string
tag
required
string
embeddingsBatchStatus
required
string
nullable
createdAt
required
string
updatedAt
required
string
deletedAt
required
string
nullable
locationName
required
string
nullable
location
required
object
id
required
string format: uuid
organizationId
required
string format: uuid
name
required
string
description
required
string
nullable
slug
required
string
address1
required
string
nullable
address2
required
string
nullable
city
required
string
nullable
state
required
string
nullable
zip
required
string
nullable
latitude
required
number
nullable >= -140737488355328 <= 140737488355327
longitude
required
number
nullable >= -140737488355328 <= 140737488355327
status
required
string
Allowed values: active inactive
type
required
string
Allowed values: equipment location
parentId
required
string format: uuid
nullable
externalId
required
string
nullable
createdById
required
string format: uuid
nullable
lastEditedById
required
string format: uuid
nullable
searchText
nullable
createdAt
required
string
updatedAt
required
string
deletedAt
required
string
nullable
parentExternalId
required
string
nullable
ownerName
required
string
nullable
statusName
required
string
nullable
meta
required
object
pagination
required
object
page
required
number
limit
required
number
total
required
number
totalPages
required
number
hasNext
required
boolean
hasPrev
required
boolean
Example
{
  "data": [
    {
      "eventDate": "2026-05-19T14:23:00.000Z",
      "location": {
        "status": "active",
        "type": "equipment"
      }
    }
  ]
}

401

Section titled “401”

Unauthorized

Media typeapplication/json
object
code
required
string
message
required
string
details
object
key
additional properties
nullable
Examplegenerated
{
  "code": "example",
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}