---
title: "Search AI-detected driving events"
method: POST
path: "/aievents/search"
tags: ["ai-events"]
---

# Search AI-detected driving events

`POST /aievents/search`

Search for AI-detected driving events filtered by date range, event type, and more.

## Request body

- AIEventSearch — Date range must be 31 days or less.
  - `startDate` string, date-time
  - `endDate` string, date-time
  - `types` string[]
  - `limit` integer
  - `offset` integer

## Response `200`

AI events

- object
  - `data` 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
  - `total` integer
  - `limit` integer
  - `offset` integer

## Other responses

- `400` — Bad Request — invalid geometry, missing required fields, or malformed JSON
- `402` — Payment Required — insufficient credits
- `403` — Forbidden — missing or invalid API key
- `429` — Too Many Requests — rate limit exceeded (default: 100 req/min)

---

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