Huéspedes

Consulta de los viajeros registrados en cada check-in y del estado de su firma.

Los huéspedes no se crean por API: se registran ellos mismos desde el enlace del check-in. Así los datos llegan validados en vivo (letra del DNI, formato NIE, municipio INE, parentesco de menores…) y la firma queda siempre dentro del flujo con evidencia. Tu integración los consume en lectura.

Listar huéspedes de un check-in

GET/checkins/{reservationId}/guests

curl

curl https://api.kinapi.es/api/v1/checkins/R-2026-0412/guests \
  -H "ocp-apim-subscription-key: TU_API_KEY"

200 OK

{
  "results": [
    {
      "id": "5f0c33f1-…",
      "nombre": "María",
      "apellido1": "García",
      "apellido2": "López",
      "tipoDocumento": "NIF",
      "numeroDocumento": "12345678Z",
      "nacionalidad": "ESP",
      "fechaNacimiento": "1990-04-12",
      "esMenor": false,
      "isLead": true,
      "telefono": "+34600111222",
      "correo": "maria@example.com",
      "registeredAt": "2026-08-10T18:03:11.000Z",
      "signedAt": "2026-08-10T18:05:40.000Z"
    }
  ]
}

signedAt indica si ese huésped ya firmó su parte del contrato; cuando todos tienen firma, el check-in pasa a signed y se genera el contrato definitivo.

Campos del huésped

Los nombres de campo siguen la nomenclatura del parte de viajeros de SES (nombre, apellido1, tipoDocumento…), de modo que lo que ves por API es exactamente lo que se comunica al Ministerio. La nacionalidad va en ISO 3166-1 alpha-3.