Consultar Estado del PIN

Verifica el estado de configuración del PIN de seguridad en la cuenta del usuario autenticado.

---

🔍 Estado del PIN

Devuelve si el usuario tiene un PIN configurado, si está activo y las fechas asociadas (si aplican).

GET/auth/pin/status

Consulta el estado del PIN de seguridad

📤 Respuesta

{
"code": 1018,
"message": "PIN status retrieved successfully.",
"data": {
  "pinConfigured": true,
  "pinActive": true,
  "configuredAt": "2025-01-15T10:30:00.000Z",
  "lastUpdated": "2025-01-20T14:45:00.000Z"
}
}

---

Headers

Header	Value
Authorization	Bearer <JWT>

---

Response (200)

data

Campo	Tipo	Descripción
pinConfigured	boolean	Indica si existe un PIN configurado (pin !== null)
pinActive	boolean	Indica si el PIN está activo
configuredAt	string | null	Timestamp ISO 8601 de creación (o null)
lastUpdated	string | null	Timestamp ISO 8601 de actualización (o null)

Ejemplo cuando el PIN no está configurado:

{
  "code": 1018,
  "message": "PIN status retrieved successfully.",
  "data": {
    "pinConfigured": false,
    "pinActive": false,
    "configuredAt": null,
    "lastUpdated": null
  }
}

---

Errores

No autorizado

HTTP 401 — Token JWT inválido, expirado o ausente.

Usuario no encontrado

HTTP 404 — code 4001 (User not found.).

Ejemplo:

{
  "code": 4001,
  "message": "User not found."
}

Error interno

HTTP 500 — code 5001 (Failed to save user to the database.).

Ejemplo:

{
  "code": 5001,
  "message": "Failed to save user to the database."
}

---

Ejemplo (cURL)

curl -X GET 'https://api.swapbits.co/auth/pin/status' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN'

---

⚡ Quick Test

GEThttps://api.swapbits.co/auth/pin/status

curl -X GET 'https://api.swapbits.co/auth/pin/status' \
  -H 'Content-Type: application/json'