# Events endpoints

Dated life events derived from people's facts, filterable by person and year.

Paths are relative to https://kleiobase.com/api/v1. Request and response schemas are in the OpenAPI document at https://kleiobase.com/api/v1/openapi.json.

## List events

`GET /workspaces/{workspace_id}/events`

Derived from people's dated facts; events have no ids. In v1 date and record_id are always null; use year.

Parameters:

- `workspace_id` (path, required): The workspace (project) id.
- `limit` (query, optional): Page size. Default 25, max 100.
- `cursor` (query, optional): The next_cursor of the previous page. Opaque.
- `person_id` (query, optional): Only events of this person.
- `year_from` (query, optional): First year, 4 digits.
- `year_to` (query, optional): Last year, 4 digits.

Responses:

- `200`: A page of events.
- `401`: Missing, malformed, unknown or revoked API key.
- `403`: The account has no paid plan.
- `404`: The workspace does not exist or is not visible to this key's owner.
- `422`: Invalid limit, cursor, person_id or year.
- `429`: Rate limit exceeded. Wait the number of seconds in Retry-After.
- `500`: Unexpected error. Retry later and quote request_id if it persists.

Canonical: https://kleiobase.com/developers/docs/reference/events