# Aktuelle Anmeldetransaktion abrufen

`GET /fapi/v1/transactions/current` · wird vom Anmeldehost der Umgebung aufgerufen

Gibt die Transaktion zurück, auf die das `__Host-idp_ltx`-Cookie verweist, einschließlich ihres Status und der Schritte, die als Nächstes ausgeführt werden können.
Verwenden Sie diesen Aufruf, um eine Anmeldeseite nach einem Neuladen fortzusetzen.

## Anfrage

Header:

| Header | Pflicht | Beschreibung |
| --- | --- | --- |
| `Idp-Client` | ja | SDK-Kennung, `<package>/<version> (<runtime>/<version>)`. |

Das Transaktions-Cookie wird vom Browser automatisch gesendet.

## Antwort

`200 OK` mit dem Transaktionsobjekt (`schema_version`, `state`, `next_steps`, `csrf_token`, `expires_at`). Jede Antwort
enthält `Cache-Control: no-store`.

Eine Transaktion, die den Benutzer auffordert, eine Unternehmensverbindung mit einem bestehenden Konto zu verknüpfen, enthält außerdem `account_link`
(`connection_name`, `organization_name`); siehe [Anmeldeschritt ausführen](/docs/api/fapi/transactions/run-step). Die gehostete
Seite greift darauf mit `resume=1` zu und setzt sie fort, anstatt eine neue Transaktion zu erstellen. Dasselbe gilt nach einer Unternehmensanmeldung, die noch einen zweiten Faktor (`second_factor_pending`) oder eine Registrierung (`enrollment_pending`) benötigt.

## DPoP-gebundene Headless-Transaktionen

Für eine Transaktion, die mit einem `DPoP`-Header gestartet wurde, senden Sie einen neuen Nachweis mit demselben Schlüssel (`htm` `GET`, `htu` diese URL). Der
Server gibt die neueste nicht abgelaufene Transaktion zurück, die an diesen Schlüssel gebunden ist. Der Autorisierungscode wird hier nie zurückgegeben.

## Fehler

| Status | Code | Wann |
| --- | --- | --- |
| 400 | `malformed_request` | `Idp-Client` fehlt. |
| 410 | `transaction_expired` | Es gibt kein Cookie, das Cookie ist ungültig oder die Transaktion ist beendet. |
| 401 | `invalid_dpop_proof` | Der `DPoP`-Nachweis ist ungültig oder wurde wiederverwendet. |

## Beispiel

```bash
curl https://example.keenauth.app/fapi/v1/transactions/current \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt
```

## Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Profil des Endnutzers. [Personenbezogene Daten in den KeenAuth-APIs](/docs/policies/personal-data) beschreibt, welche Daten gespeichert werden, wie lange sie aufbewahrt werden und wie sie gelöscht werden. Senden Sie keine besonderen Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung) in irgendeinem Feld.