/api/v1/access-grants/{id}/activityZugriffsprotokoll einer Zugangsberechtigung
Die Protokollzeilen der Berechtigung, neueste zuerst, per Cursor. Ereignisse (grant_created, grant_changed, grant_revoked) nennen, wer gehandelt hat: via ist der API-Schlüssel (mit seinem Label) oder die OAuth-App und null für das Dashboard; actorId ist der Nutzer, für den gehandelt wurde. read-Zeilen tragen eine Zahl pro Pass, Kanal und Tag.
Es werden keine IP-Adressen gespeichert, Zeilen werden nach 24 Monaten gelöscht. Eine ID eines anderen Unternehmens ergibt 404.
Wer darf aufrufen. Ein API-Schlüssel nur, wenn sein Eigentümer „May manage access grants“ für diesen Schlüssel auf der Developer-Seite eingeschaltet hat (standardmäßig aus; sonst 403 access_grants_not_enabled). Ein OAuth-Token braucht den Scope access_grants:read und mindestens die Rolle Editor.
Pfad-Parameter
- iderforderlich
string (24 hex chars)
ID der Zugangsberechtigung.
Query-Parameter
- limit
integer
Seitengröße, 1 bis 100 (Standard 50).
- cursor
string (24 hex chars)
Der
nextCursorder vorherigen Seite.
Header
- Authorizationerforderlich
string
Bearer <token>— entweder eintp_API-Schlüssel (Developer → API Keys; am einfachsten, für Server-zu-Server) oder ein OAuth-2.0-Access-Token (Developer → OAuth Apps; für nutzerautorisierte Apps, scoped und widerrufbar). Die Authentication-Seite enthält den vollständigen OAuth-Flow und die Scope-Liste.e.g. Bearer tp_REDACTED_xxxxxxxxxxxx
Anfrage
curl -sS https://app.tracepass.eu/api/v1/access-grants/6650c1d2e3f4a5b6c7d8e9f0/activity \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"Antwort
{
"data": [
{
"id": "6650d2e3f4a5b6c7d8e9f0a1",
"kind": "grant_created",
"day": "2026-06-01T00:00:00.000Z",
"channel": null,
"passportId": null,
"count": null,
"detail": null,
"actorId": "6650a0a0a0a0a0a0a0a0a0a0",
"via": { "kind": "api_key", "keyId": "6650b0b0b0b0b0b0b0b0b0b0", "label": "SAP prod" },
"lastAt": "2026-06-01T09:30:00.000Z"
}
],
"nextCursor": null
}