TracePass
Zugangsberechtigungen

Zugangsberechtigung lesen

Eine Berechtigung Ihres Unternehmens, aktiv, abgelaufen oder widerrufen. Das Feld state sagt, welche. Die Antwort enthält nie das Token oder einen Teil davon.

GET/api/v1/access-grants/{id}
OpenAPI 3.1 herunterladen
GET/api/v1/access-grants/{id}

Zugangsberechtigung lesen

Eine Berechtigung Ihres Unternehmens, aktiv, abgelaufen oder widerrufen. Das Feld state sagt, welche. Die Antwort enthält nie das Token oder einen Teil davon.

Eine ID, die einem anderen Unternehmen gehört, ergibt 404, genau wie eine nicht vorhandene ID, und verrät nichts darüber.

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.

Header

  • Authorizationerforderlich

    string

    Bearer <token> — entweder ein tp_ 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 \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Antwort

{
  "data": {
    "id": "6650c1d2e3f4a5b6c7d8e9f0",
    "accessLevel": "restricted",
    "label": "Buyer GmbH, order 4711",
    "role": "purchaser",
    "scope": { "kind": "passports", "ids": ["6650a1b2c3d4e5f6a7b8c9d0"] },
    "purpose": null,
    "evidence": null,
    "state": "active",
    "expiresAt": null,
    "useCount": 0,
    "createdAt": "2026-06-01T09:30:00.000Z"
  }
}