---
title: Zugangsberechtigungen auflisten
description: Zugangsberechtigungen per Cursor auflisten, filterbar nach Rolle, Status, Pass oder Produkt. Gibt nie ein Token zurück. Braucht Schlüssel-Schalter oder OAuth.
canonical: "https://www.tracepass.eu/de/docs/list-access-grants"
locale: de
source: "https://www.tracepass.eu/de/docs/list-access-grants"
---

# Zugangsberechtigungen auflisten

> Zugangsberechtigungen per Cursor auflisten, filterbar nach Rolle, Status, Pass oder Produkt. Gibt nie ein Token zurück. Braucht Schlüssel-Schalter oder OAuth.

```http
GET /api/v1/access-grants
```

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.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Authorization` | header | string | yes | `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. |
| `role` | query | string | no | Nur Berechtigungen dieser Rolle, z. B. `purchaser`. |
| `status` | query | string (active \| expired \| revoked) | no | Nur Berechtigungen in diesem Zustand. |
| `passportId` | query | string (24 hex chars) | no | Nur Berechtigungen, die diesen Pass abdecken. |
| `productId` | query | string (24 hex chars) | no | Nur unternehmensweite Berechtigungen und solche für dieses Produkt. |
| `limit` | query | integer | no | Seitengröße, 1 bis 100 (Standard 50). |
| `cursor` | query | string (24 hex chars) | no | Der `nextCursor` der vorherigen Seite. |

## Examples

```bash
curl -sS "https://app.tracepass.eu/api/v1/access-grants?status=active&role=purchaser" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"
```

```typescript
const res = await fetch(
  "https://app.tracepass.eu/api/v1/access-grants?status=active&role=purchaser",
  { headers: { Authorization: `Bearer ${process.env.TRACEPASS_API_KEY}` } },
);
const { data, nextCursor } = await res.json();
```

```python
import os, requests
res = requests.get(
    "https://app.tracepass.eu/api/v1/access-grants",
    params={"status": "active", "role": "purchaser"},
    headers={"Authorization": f"Bearer {os.environ['TRACEPASS_API_KEY']}"},
)
res.raise_for_status()
body = res.json()
```

## Responses

### 200 — Seite mit Berechtigungen

```json
{
  "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
}
```

### 403 — Schalter aus

```json
{
  "error": "access_grants_not_enabled",
  "message": "This API key may not manage access grants. Its owner can switch on 'May manage access grants' for the key on the Developer page."
}
```

## Related

- [Zugangsberechtigung erstellen](https://www.tracepass.eu/de/docs/create-access-grant.md)
- [Zugangsberechtigung lesen](https://www.tracepass.eu/de/docs/get-access-grant.md)
