---
title: "GET /v1/projects/{projectOrProductUID}/events"
method: GET
path: "/v1/projects/{projectOrProductUID}/events"
tags: ["event"]
---

# GET /v1/projects/{projectOrProductUID}/events

`GET /v1/projects/{projectOrProductUID}/events`

Get Events of a Project

## Path parameters

- `projectOrProductUID` string, required

## Query parameters

- `pageSize` integer
- `pageNum` integer
- `deviceUID` string[]
- `sensorUID` string[]
- `sortBy` 'best_id' | 'device_serial' | 'device_uid' | 'captured' | 'modified' | 'device_location' | 'tower_location' | 'triangulated_location' | 'best_location'
- `sortOrder` 'asc' | 'desc'
- `startDate` integer
- `endDate` integer
- `dateType` 'captured' | 'uploaded'
- `systemFilesOnly` boolean
- `files` string
- `format` 'json' | 'csv'
- `serialNumber` string[]
- `fleetUID` string[]
- `sessionUID` string[]
- `eventUID` string[]
- `selectFields` string
- `deviceUIDs` string[]
- `since` string

## Response `200`

The response body from a GET events request.

- object
  - `events` Event[], required
    - `app` string — App UID (globally unique)
    - `bars` integer — Bars. Only available on _session.qo events.
    - `best_country` string — Country
    - `best_id` string — The device serial number, or the DeviceUID if the serial number is not set
    - `best_lat` number, double — Latitude
    - `best_location` string — Location
    - `best_location_type` string — One of "gps", "triangulated", or "tower"
    - `best_location_when` integer — Unix timestamp
    - `best_lon` number, double — Longitude
    - `best_timezone` string — Timezone
    - `body` object — A JSON object containing event details
    - `bssid` string — BSSID. Only available on _session.qo events.
    - `device` string — Device UID (globally unique)
    - `environment` object — Routed environment variables beginning with "$". Only available on _session.qo events.
    - `event` string — Event UID (globally unique)
    - `file` string — The notefile associated with this event
    - `moved` integer — The number of times the device was sensed to have moved between the last session and this session. Only available on _session.qo events.
    - `note` string — The note ID in the notefile
    - `ordering_code` string — Ordering code. Only available on _session.qo events.
    - `orientation` string — The orientation of the device. Only available on _session.qo events.
    - `payload` string — A base64-encoded binary payload
    - `product` string — Product UID (globally unique)
    - `rat` string — Rat. Only available on _session.qo events.
    - `received` number, double — The unix timestamp when the event was received
    - `req` string — The notecard request
    - `rsrp` integer — RSRP. Only available on _session.qo events.
    - `rsrq` integer — RSRQ. Only available on _session.qo events.
    - `rssi` integer — Received Signal Strength Indicator (RSSI) is an estimated measurement of how well a device can receive signals. Only available on _session.qo events.
    - `sensor` string — Sensor UID, for events originating from a sensor attached to the device
    - `session` string — Session UID (globally unique)
    - `sinr` integer — SINR. Only available on _session.qo events.
    - `sku` string — SKU. Only available on _session.qo events.
    - `sn` string — The device serial number
    - `ssid` string — SSID. Only available on _session.qo events.
    - `temp` number, double — Device temperature. Only available on _session.qo events.
    - `tls` boolean — Whether TLS was used on the connection between the device and notehub. Only available on _session.qo events.
    - `tower_country` string — Country
    - `tower_id` string — Tower ID
    - `tower_lat` number, double — Latitude
    - `tower_location` string — Location
    - `tower_lon` number, double — Longitude
    - `tower_timezone` string — Timezone
    - `tower_when` integer — Unix timestamp
    - `transport` string — The transport used for this event, e.g., "cellular", "wifi", ", etc.
    - `tri_country` string — Country
    - `tri_lat` number, double — Latitude
    - `tri_location` string — Location
    - `tri_lon` number, double — Longitude
    - `tri_points` integer — Triangulation points
    - `tri_timezone` string — Timezone
    - `tri_when` integer — Unix timestamp
    - `updates` integer
    - `voltage` number, double — Device voltage. Only available on _session.qo events.
    - `when` integer — When the event was captured on the device
    - `when_ms` integer — Millisecond-accurate Unix epoch timestamp for when the event was captured on the device
    - `where_country` string — Country
    - `where_lat` number, double — Latitude
    - `where_location` string — Location
    - `where_lon` number, double — Longitude
    - `where_olc` string — Open Location Code
    - `where_timezone` string — Timezone
    - `where_when` integer — Unix timestamp
  - `has_more` boolean, required — True if there are more events
  - `through` string — The UID of the last event returned

## Other responses

- `default` — The response body in case of an API error.

---

[API](https://skmtc.net/notefile/apis/notehub-api.md) · [All operations](https://skmtc.net/notefile/apis/notehub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notefile/notehub-api/versions/9c5b2b63a991/schema)