# Ottieni la transazione di accesso corrente

`GET /fapi/v1/transactions/current` · chiamato dall'host di accesso dell'ambiente

Restituisce la transazione a cui punta il cookie `__Host-idp_ltx`, incluso il suo stato e i passaggi che possono essere eseguiti successivamente.
Usalo per riprendere una pagina di accesso dopo un ricaricamento.

## Richiesta

Header:

| Header | Obbligatorio | Descrizione |
| --- | --- | --- |
| `Idp-Client` | sì | Identificatore dell'SDK, `<package>/<version> (<runtime>/<version>)`. |

Il cookie della transazione viene inviato automaticamente dal browser.

## Risposta

`200 OK` con l'oggetto transazione (`schema_version`, `state`, `next_steps`, `csrf_token`, `expires_at`). Ogni risposta
contiene `Cache-Control: no-store`.

Una transazione che chiede all'utente di collegare una connessione enterprise a un account esistente contiene anche `account_link`
(`connection_name`, `organization_name`); vedi [Esegui un passaggio di accesso](/docs/api/fapi/transactions/run-step). La pagina ospitata
lo raggiunge con `resume=1` e lo continua invece di creare una nuova transazione. Lo stesso accade dopo un accesso enterprise
che richiede ancora un secondo fattore (`second_factor_pending`) o la registrazione (`enrollment_pending`).

## Transazioni headless vincolate a DPoP

Per una transazione avviata con un header `DPoP`, invia una nuova prova dalla stessa chiave (`htm` `GET`, `htu` questo URL); il
server restituisce la transazione non scaduta più recente vincolata a quella chiave. Il codice di autorizzazione non viene mai restituito qui.

## Errori

| Stato | Codice | Quando |
| --- | --- | --- |
| 400 | `malformed_request` | `Idp-Client` manca. |
| 410 | `transaction_expired` | Non c'è cookie, il cookie non è valido o la transazione è terminata. |
| 401 | `invalid_dpop_proof` | La prova `DPoP` non è valida o è stata riutilizzata. |

## Esempio

```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
```

## Dati personali

Questo endpoint contiene dati personali: profilo dell'utente finale. [Dati personali nelle API di KeenAuth](/docs/policies/personal-data) descrive cosa viene memorizzato, per quanto tempo viene conservato e come viene eliminato. Non inviare categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale) in alcun campo.