# Einladungen auflisten

`GET /v1/invitations` · Berechtigung `invitations:read`

Listet die Einladungen der Umgebung auf, die älteste zuerst. Es wird nur die Vorwärtspaginierung unterstützt. Filter: `organization_id`, `email` (exakte Übereinstimmung) und `status`. Der Cursor ist an die Filter gebunden; die E-Mail-Adresse fließt nur als geschützter Hash in den Cursor ein. Annahmelinks werden nie aufgelistet.

## Anfrage

| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `limit` | query | nein | 1–100, Standard 20. |
| `after` | query | nein | Cursor aus `list_metadata.after`. |
| `organization_id` | query | nein | Organisations-ID (`org_…`). |
| `email` | query | nein | E-Mail-Adresse (exakte Übereinstimmung). |
| `status` | query | nein | `pending`, `accepted`, `revoked` oder `expired`. |

Kein Anfragetext.

## Antwort

`200 OK` mit einer Seite von Einladungen.

```json
{
  "data": [
    {
      "id": "inv_01j9xt9v3w4y8z0a2b4c6d8e0g",
      "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "email": "ada@example.com",
      "role_ids": [
        "rol_01j9xr7s1t2w6x8y0z2a4b6c8e"
      ],
      "application_id": null,
      "delivery": "link_only",
      "delivery_status": "not_sent",
      "status": "pending",
      "send_count": 1,
      "last_sent_at": "2026-10-12T09:31:00.123456Z",
      "expires_at": "2026-10-19T09:31:00.123456Z",
      "accepted_user_id": null,
      "accepted_at": null,
      "revoked_at": null,
      "created_at": "2026-10-12T09:31:00.123456Z",
      "updated_at": "2026-10-12T09:31:00.123456Z",
      "version": 1
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}
```

## Fehler

| HTTP | Code | Wann |
|---|---|---|
| 400 | `invalid_cursor` | Der Cursor ist ungültig oder gehört zu anderen Filtern. |
| 422 | `validation_failed` | Ein Filter oder `limit` ist ungültig, oder `before` bzw. eine `order` ungleich `asc` wurde angegeben. |
| 401 | `unauthenticated` | Das Authentifizierungsmerkmal fehlt, ist ungültig oder wurde widerrufen. |
| 403 | `insufficient_permissions` | Das Authentifizierungsmerkmal hat nicht die erforderliche Berechtigung. |
| 429 | `rate_limited` | Das Ratenlimit wurde überschritten. Wiederholen Sie die Anfrage nach dem Zeitraum aus `Retry-After`. |
| 503 | `service_unavailable` | Eine Abhängigkeit ist vorübergehend nicht verfügbar. Wiederholen Sie die Anfrage nach dem Zeitraum aus `Retry-After`. |

## Beispiel

```bash
curl -i "https://api.eu.keenauth.com/v1/invitations?organization_id=org_01j9xk3m7q8r2s4t6v8w0y2z4a&status=pending" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

## Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Organisationsmitgliedschaften und Einladungen. [Personenbezogene Daten in den KeenAuth-APIs](/docs/policies/personal-data) beschreibt, was gespeichert wird, wie lange die Daten aufbewahrt werden und wie sie gelöscht werden. Übermitteln Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).