# Obtener la transacción de inicio de sesión actual

`GET /fapi/v1/transactions/current` · llamado desde el host de inicio de sesión del entorno

Devuelve la transacción a la que apunta la cookie `__Host-idp_ltx`, incluido su estado y los pasos que pueden ejecutarse a continuación.
Úsela para reanudar una página de inicio de sesión después de recargarla.

## Solicitud

Encabezados:

| Encabezado | Obligatorio | Descripción |
| --- | --- | --- |
| `Idp-Client` | sí | Identificador del SDK, `<package>/<version> (<runtime>/<version>)`. |

El navegador envía automáticamente la cookie de la transacción.

## Respuesta

`200 OK` con el objeto de transacción (`schema_version`, `state`, `next_steps`, `csrf_token`, `expires_at`). Cada respuesta
incluye `Cache-Control: no-store`.

Una transacción que pide al usuario vincular una conexión empresarial con una cuenta existente también incluye `account_link`
(`connection_name`, `organization_name`); consulte [Ejecutar un paso de inicio de sesión](/docs/api/fapi/transactions/run-step). La página alojada
lo obtiene con `resume=1` y la continúa en lugar de crear una nueva transacción. Hace lo mismo después de un
inicio de sesión empresarial que todavía necesita un segundo factor (`second_factor_pending`) o un registro (`enrollment_pending`).

## Transacciones sin interfaz vinculadas a DPoP

En una transacción iniciada con un encabezado `DPoP`, envíe una nueva prueba con la misma clave (`htm` `GET`, `htu` esta URL); el
servidor devuelve la transacción vigente más reciente vinculada a esa clave. El código de autorización nunca se devuelve aquí.

## Errores

| Estado | Código | Cuándo |
| --- | --- | --- |
| 400 | `malformed_request` | Falta `Idp-Client`. |
| 410 | `transaction_expired` | No hay cookie, la cookie no es válida o la transacción ha finalizado. |
| 401 | `invalid_dpop_proof` | La prueba `DPoP` no es válida o se reutilizó. |

## Ejemplo

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

## Datos personales

Este endpoint trata datos personales: perfil del usuario final. [Datos personales en las API de KeenAuth](/docs/policies/personal-data) describe qué se almacena, durante cuánto tiempo se conserva y cómo se elimina. No envíe categorías especiales de datos personales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.