TracePass
Zugangsberechtigungen

Zugangsberechtigungen auflisten

Die Zugangsberechtigungen des Unternehmens, neueste zuerst, per Cursor. Eine Zugangsberechtigung ist die Berechtigung, mit der ein Empfänger (Käufer, Reparaturbetrieb, Recycler) den eingeschränkten Teil eines Passes liest. Die Liste gibt nie ein Token zurück, auch keinen Teil davon.

GET/api/v1/access-grants
OpenAPI 3.1 herunterladen
GET/api/v1/access-grants

Zugangsberechtigungen auflisten

Die Zugangsberechtigungen des Unternehmens, neueste zuerst, per Cursor. Eine Zugangsberechtigung ist die Berechtigung, mit der ein Empfänger (Käufer, Reparaturbetrieb, Recycler) den eingeschränkten Teil eines Passes liest. Die Liste gibt nie ein Token zurück, auch keinen Teil davon.

Filter: role, status (active, expired, revoked), passportId (Berechtigungen, die diesen Pass abdecken: unternehmensweit, sein Produkt oder der Pass selbst) und productId (unternehmensweite Berechtigungen und solche für dieses Produkt). Übergeben Sie den nextCursor der vorherigen Seite als cursor; auf der letzten Seite ist nextCursor null.

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.

Query-Parameter

  • role

    string

    Nur Berechtigungen dieser Rolle, z. B. purchaser.

  • status

    string (active | expired | revoked)

    Nur Berechtigungen in diesem Zustand.

  • passportId

    string (24 hex chars)

    Nur Berechtigungen, die diesen Pass abdecken.

  • productId

    string (24 hex chars)

    Nur unternehmensweite Berechtigungen und solche für dieses Produkt.

  • limit

    integer

    Seitengröße, 1 bis 100 (Standard 50).

  • cursor

    string (24 hex chars)

    Der nextCursor der vorherigen Seite.

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?status=active&role=purchaser" \
  -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"
    }
  ],
  "nextCursor": null
}