---
title: "List project event definitions"
method: GET
path: "/event-definitions"
tags: ["Events"]
---

# List project event definitions

`GET /event-definitions`

Returns the event definitions registered for the project associated with
your API key. Definitions describe event names, meanings, and property
schemas. Emitting a new event through `/events` can create a minimal
definition automatically, but use this endpoint when you want to manage
definition metadata directly.

## Query parameters

- `include_archived` boolean

## Response `200`

Success

- ProjectEventDefinitionListResponse
  - `data` ProjectEventDefinition[], required
    - `id` string, uuid, required — Unique event definition ID
    - `name` string, required — Event name. Must be lowercase and may contain optional dot-separated segments. Each segment starts with a lowercase letter and may contain lowercase letters, numbers, and underscores. Maximum 128 characters.
    - `description` string, nullable — Human-readable description of what this event means
    - `property_schema` object, required — Declared properties for this event. Values are keyed by property name.
    - `last_seen_at` string, date-time, nullable — Timestamp of the latest emitted event with this definition, when available.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `archived_at` string, date-time, nullable, required — Timestamp when the definition was archived, or null when active.

## Other responses

- `401` — Missing or invalid API key

---

[API](https://skmtc.net/kapso/apis/kapso-platform-api.md) · [All operations](https://skmtc.net/kapso/apis/kapso-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kapso/kapso-platform-api/revisions/18ff5548a33f/schema)