Ressourcen

Ereignisse

Jeder Ereignisse-Endpunkt, mit dem Scope, den er durchsetzt, dem Körper, den er annimmt, einer lesbaren Antwort und den Ablehnungen, die er zurückgeben kann.

Den Ereignis-Feed der Organisation lesen.

get/organizations/{organization}/events

Scope: events:read
Idempotency-Key: Wird nicht akzeptiert
Liefert: 200

Pfadparameter

organizationZeichenkettePflicht

Die Organisation, für die diese Anfrage handelt. Der Zugangsschlüssel muss dafür freigegeben sein.

Abfrageparameter

limitZeichenketteOptional

Wie viele Datensätze zurückgegeben werden. Der Server darf weniger liefern.

cursorZeichenketteOptional

Der next_cursor der vorherigen Seite. Der Feed beginnt beim ÄLTESTEN Ereignis, dieser Cursor liest also vorwärts in Ereignisse, die Sie noch nicht gesehen haben. Ein Cursor kodiert die Filter, unter denen er ausgegeben wurde; wird er mit anderen Filtern gesendet, folgt eine Ablehnung mit cursor_invalid.

typeZeichenkette, wiederholbarOptional

Mehrfach angeben, um auf mehr als einen Ereignistyp zu filtern. Weglassen, um alle Typen zu erhalten.

Fehler

Jede Ablehnung, die dieser Endpunkt zurückgeben kann, samt dem HTTP-Status, mit dem sie eintrifft.

Anfrage

curl "https://passportcraft.com/api/v1/organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/events?type=passport.published&limit=25" \
  -H "Authorization: Bearer $PASSPORTCRAFT_API_KEY"

Antwort · 200

{
  "object": "list",
  "data": [
    {
      "object": "event",
      "id": "e3b0c442-98fc-4c14-9afb-f4c8996fb924",
      "name": "organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/events/e3b0c442-98fc-4c14-9afb-f4c8996fb924",
      "organization_id": "8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2",
      "type": "passport.published",
      "livemode": true,
      "created_at": "2026-08-01T14:03:22.501Z",
      "related": {
        "object": "passport",
        "id": "2c1f9e07-3b4d-4a18-9f6c-5e0a7b8d3c41",
        "name": "organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/passports/2c1f9e07-3b4d-4a18-9f6c-5e0a7b8d3c41",
        "category": "textile",
        "status": "published",
        "previous_status": "draft",
        "version": 4
      }
    }
  ],
  "has_more": false,
  "next_cursor": "eyJjIjoiMjAyNi0wOC0wMVQxNDowMzoyMi41MDFaIn0"
}

GET /organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/events?type=passport.published&limit=25