---
title: "Get AI event by ID"
method: GET
path: "/aievents/{id}"
tags: ["ai-events"]
---

# Get AI event by ID

`GET /aievents/{id}`

Retrieve a single AI event with optional high-frequency sensor data.

## Path parameters

- `id` string, required

## Query parameters

- `includeGnssData` boolean
- `includeImuData` boolean

## Response `200`

AI event details

- AIEvent
  - `id` string
  - `type` string
  - `timestamp` string, date-time
  - `lat` number
  - `lng` number
  - `videoUrl` string, uri — Signed video URL (temporary)
  - `duration` number — Video duration in seconds
  - `gnssData` object[] — GPS trace (~1Hz), included when includeGnssData=true
    - `timestamp` number
    - `lat` number
    - `lon` number
  - `imuData` object[] — IMU data (~100Hz), included when includeImuData=true
    - `timestamp` number
    - `ax` number
    - `ay` number
    - `az` number
    - `gx` number
    - `gy` number
    - `gz` number

## Other responses

- `402` — Payment Required — insufficient credits
- `403` — Forbidden — missing or invalid API key

---

[API](https://skmtc.net/beemaps/apis/bee-maps-data-api.md) · [All operations](https://skmtc.net/beemaps/apis/bee-maps-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/beemaps/bee-maps-data-api/revisions/fcbfc9ebaf37/schema)