Entwicklerportal
API-Referenz

Termin abrufen

Einzelnen oeffentlichen Termin abrufen.

GET
/events/{eventId}

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

Path Parameters

eventId*string

Oeffentliche NanoID des Termins.

Response Body

Der Termin.

application/json
  1. response
id*string

Oeffentliche NanoID.

title*string
startsAt*string
Formatdate-time
endsAt?string
Formatdate-time
locationId?string
visibility*string
Value in"public""members"
Example Request
curl -X GET 'https://api.sandbox.example/v1/events/evt_9mKq2pX7'
Example Response
{  "id": "evt_9mKq2pX7",  "title": "Kreisparteitag Musterpartei",  "startsAt": "2019-08-24T14:15:22Z",  "endsAt": "2019-08-24T14:15:22Z",  "locationId": "loc_3bQ8vR1",  "visibility": "public"}

Termine auflisten

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

Veranstaltungsorte auflisten

Liefert oeffentlich sichtbare Veranstaltungsorte einer Gliederung.