---
title: "List scored events"
method: GET
path: "/v1/events"
tags: ["Events"]
---

# List scored events

`GET /v1/events`

## Request

- Base URL: `https://api.kaidn.io`
- URL: `https://api.kaidn.io/v1/events`
- Auth: API key in header `x-api-key`

Newest first. Filter by verdict or event type, search device fingerprints and user ids with q, and page with limit and offset.

## Query parameters

- `limit` string
- `offset` string
- `verdict` 'allow' | 'review' | 'block'
- `event` string
- `q` string

## Response `200`

Success. Field-level shape for this endpoint is documented at https://kaidn.io/docs.

- object: Success. Field-level shape for this endpoint is documented at https://kaidn.io/docs.

## Other responses

- `400`: The request body or query string failed validation.
- `401`: Missing or invalid API key.
- `429`: Rate limit exceeded. Back off and retry.

---

[API](https://skmtc.dev/kaidn/apis/kaidn-api.md) · [All operations](https://skmtc.dev/kaidn/apis/kaidn-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kaidn/apis/kaidn-api/revisions/6f0706942d0e?raw)