# Einladungen einer Organisation auflisten

`GET /fapi/v1/organizations/{org_id}/invitations` · wird vom Anmeldehost der Umgebung aufgerufen

Listet die Einladungen einer Organisation in der Reihenfolge ihrer Erstellung auf, zum Beispiel für eine Profilansicht der Organisation. Eine ausstehende Einladung zeigt die eingeladene Adresse nur an, wenn Sie zusätzlich `idp_members:read` besitzen; andernfalls ist `email` gleich `null`. Angenommene, widerrufene und abgelaufene Einladungen enthalten nie eine Adresse.

Erforderlich ist das Cookie `__Host-idp_session` des authentifizierten Benutzers oder ein Zugriffstoken der Front API einer Anwendung der ersten Partei (`Authorization: DPoP <token>` mit einem DPoP-Nachweis; siehe [Zugriffstoken der Front API](/docs/api/fapi/front-api-token)). Der Benutzer muss aktives Mitglied der Organisation sein und die Berechtigung `idp_members:invite` besitzen. Ein Benutzer, der kein Mitglied ist, erhält `404 not_found`; ein Mitglied ohne die Berechtigung erhält `403 insufficient_permissions`.

Mit `@keenauth/js`: `await keenauth.organizations.invitations(orgId, { status: "pending" })`.

## Anfrage

Header:

| Header | Erforderlich | Beschreibung |
| --- | --- | --- |
| `Idp-Client` | ja | Kennung des SDK. |

`org_id`: die Kennung der Organisation (`org_…`).

Abfrageparameter:

| Parameter | Erforderlich | Beschreibung |
| --- | --- | --- |
| `status` | nein | `pending`, `accepted`, `revoked` oder `expired`; ohne Angabe alle vier. |
| `after` | nein | Der Wert `next_after` der vorherigen Seite. |
| `limit` | nein | 1–100, Standardwert 20. |

Kein Body.

## Antwort

`200 OK` mit `{"data": [...], "next_after": "..."}`; `next_after` fehlt auf der letzten Seite. Jeder Eintrag hat die Felder von [einer Einladung](/docs/api/fapi/organizations/invitations/create).

## Fehler

| Status | Code | Wann |
| --- | --- | --- |
| 400 | `invalid_cursor` | `after` ist fehlerhaft formatiert. |
| 401 | `unauthenticated` | Kein gültiges Sitzungs-Cookie oder Token. |
| 403 | `insufficient_permissions` | Der Benutzer besitzt `idp_members:invite` in der Organisation nicht. |
| 404 | `not_found` | Keine solche Organisation für diesen Benutzer; eine unbekannte, fehlerhafte oder fremde Kennung führt zu derselben Antwort. |
| 422 | `validation_failed` | `status` oder `limit` ist ungültig. |
| 503 | `service_unavailable` | Vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach `Retry-After`. |

## Beispiel

```bash
curl "https://example.keenauth.app/fapi/v1/organizations/org_01jbz6x8kq3m2n4p5r6s7t8v9a/invitations?status=pending&limit=1" \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt
```

```json
{
  "data": [
    {
      "id": "inv_01jbz6x8kq3m2n4p5r6s7t8v9d",
      "email": "new.member@example.com",
      "role_ids": ["rol_01jbz6x8kq3m2n4p5r6s7t8v9w"],
      "delivery": "email",
      "delivery_status": "sent",
      "status": "pending",
      "send_count": 1,
      "last_sent_at": "2026-11-03T10:00:00Z",
      "expires_at": "2026-11-10T10:00:00Z",
      "accepted_user_id": null,
      "accepted_at": null,
      "revoked_at": null,
      "created_at": "2026-11-03T10:00:00Z",
      "updated_at": "2026-11-03T10:00:00Z",
      "version": 1
    }
  ],
  "next_after": "inv_01jbz6x8kq3m2n4p5r6s7t8v9d"
}
```

## Personenbezogene Daten

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