Entwicklerportal
API-Referenz

Termine auflisten

Liefert oeffentliche Termine. Anonyme Aufrufe (`view`) erhalten nur oeffentliche Felder; authentifizierte Aufrufe mit `read:events` zusaetzlich geschuetzte Felder (Field-Projection, server-autoritativ).

GET
/events

Authorization

headerAuthorizationBearer <pc_live_… / pc_test_…>

Persoenlicher oder Dienstkonto-API-Key als Authorization: Bearer pc_live_… (Produktion) bzw. pc_test_… (Sandbox). In der Sandbox sind nur pc_test_-Keys gueltig. (ADR-0104)

Scope: read:events

Query Parameters

cursor?string

Cursor der naechsten Seite (aus page.nextCursor). Cursor-basierte Pagination.

limit?integer

Maximale Anzahl Elemente pro Seite (1–100).

Range1 <= value <= 100
Default25
from?string

Nur Termine ab diesem Zeitpunkt (ISO-8601 UTC).

Formatdate-time

Response Body

Seite von Terminen.

application/json
  1. response
data*array<>
page*
Example Request
curl -X GET 'https://api.sandbox.example/v1/events'
Example Response
{  "data": [    {      "id": "evt_9mKq2pX7",      "title": "Kreisparteitag Musterpartei",      "startsAt": "2026-11-14T18:00:00Z",      "endsAt": "2026-11-14T21:00:00Z",      "locationId": "loc_3bQ8vR1",      "visibility": "public"    }  ],  "page": {    "nextCursor": "ZXZ0XzlwWA",    "hasMore": true  }}