Skip to main content
GET
Read alerts

Authorizations

Authorization
string
header
required

Use a valid Bearer token to authenticate.

Query Parameters

status
enum<string>

Resolution filter. unresolved (default), resolved, or all. Example: all

Available options:
unresolved,
resolved,
all
date
string<date>

A single local day (Y-m-d). Cannot be combined with from / to. Example: 2026-10-15

from
string<date>

Start day of a range (Y-m-d). Requires to; cannot be combined with date. Example: 2026-10-01

to
string<date>

End day of a range (Y-m-d). Requires from; must be on or after from and at most 93 days after it. Example: 2026-10-15

alertCode[]
string[]

Only alerts with these codes. Repeat the parameter for several codes. Example: alertCode[]=geofence.enter&alertCode[]=idle.detected

email
string

Only alerts about this user (exact email, case-insensitive). Example: [email protected]

hubId
string

Only alerts of this hub, plus alerts with no hub. Alerts recorded before hubs were stored on alerts have no hub, so they are returned for every hub. Leave it out to get the alerts of every hub. Example: 6a712e4c2385f1c14e04beeb

page
integer
default:1

The page number of results to retrieve. Example: 2

limit
integer
default:20

Number of alerts per page. Values above 100 are capped to 100. Default 20. Example: 20

Required range: 1 <= x <= 100

Response

Success

status
boolean

Status of response.

message
string

Message of API response.

data
object

Paginated list of alerts. Each item in data.data is an Alert object: fields shared by every alert are at the top level, and fields for one kind of alert are inside the item's data, whose keys depend on alertCode. data is always an object, {} when the alert stores nothing.