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

# Lijst events

`GET /v1/events`

## Request

- Base URL: `https://api.developer.overheid.nl/tools/v1`
- URL: `https://api.developer.overheid.nl/tools/v1/v1/events`
- Auth: one of:
  - API key in header `X-Api-Key`
  - OAuth 2
    - Client credentials
    - Token URL: `https://auth.developer.overheid.nl/realms/don/protocol/openid-connect/token` scopes: `events:read`

Geeft de events uit de agenda, gesorteerd op begintijd (oplopend).

## Query parameters

- `page` integer
- `perPage` integer
- `endsAfter` string, date-time
- `startsBefore` string, date-time
- `source` 'manual' | 'pleio': Herkomst van het event. `manual` is via deze API beheerd, `pleio` is geharvest uit een Pleio-site.

## Response `200`

OK

- AgendaEvent[]
  - `title` string, required
  - `summary` string
  - `startsAt` string, date-time, required: Begin van het event (RFC 3339 met UTC-offset).
  - `endsAt` string, date-time, required: Einde van het event (RFC 3339 met UTC-offset). Mag niet vóór `startsAt` liggen.
  - `location` string
  - `url` string, uri, required: Pagina met meer informatie over het event.
  - `id` string, uuid, required
  - `source` 'manual' | 'pleio', required: Herkomst van het event. `manual` is via deze API beheerd, `pleio` is geharvest uit een Pleio-site.
  - `sourceName` string: Naam van de bron, bijvoorbeeld de host van de Pleio-site.
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Bad request
- `503`: Service unavailable

## Changes

- **2026-10-22** `f9481ba67e7e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/overheid/apis/tools-api-v1/changes/v1/events/get.md)

---

[API](https://skmtc.dev/overheid/apis/tools-api-v1.md) - [All operations](https://skmtc.dev/overheid/apis/tools-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/overheid/apis/tools-api-v1/revisions/f9481ba67e7e?raw)