Check-ins

El recurso central de la API: un check-in por reserva, identificado siempre por tu reservationId.

El objeto check-in

Objeto

{
  "reservationId": "R-2026-0412",
  "listingId": "38291",
  "confirmationCode": "HMXK4L",
  "source": "direct",
  "checkInDate": "2026-08-14",
  "checkOutDate": "2026-08-18",
  "arrivalTime": "16:00",
  "departureTime": "11:00",
  "numGuestsExpected": 4,
  "numGuestsConfirmed": null,
  "status": "in_progress",
  "url": "https://checkinsas…/c/aGb3xKf9…",
  "contract": { "signed": false, "signedAt": null },
  "createdAt": "2026-07-19T10:12:00.000Z",
  "updatedAt": "2026-07-19T11:40:00.000Z"
}

Estados (status)

Campo	Tipo	Descripción
`pending`	estado	Creado; ningún huésped registrado aún.
`in_progress`	estado	Al menos un huésped registrado.
`completed`	estado	Todos los huéspedes registrados.
`signed`	estado	Contrato firmado por todo el grupo.
`submitted`	estado	Parte de viajeros enviado a SES (lote asignado).
`confirmed`	estado	SES confirmó todas las comunicaciones.
`error`	estado	Requiere intervención — ver errorReason.
`cancelled`	estado	Reserva cancelada.

Crear un check-in

POST/checkins

Body

Campo	Tipo	Descripción
`reservationId`requerido	string	Id de la reserva en tu sistema. Es el identificador público del check-in.
`listingId`requerido	string	Id del listing — debe existir una propiedad con ese listingId.
`confirmationCode`requerido	string	Código de confirmación que ve el huésped.
`checkInDate`requerido	AAAA-MM-DD	Fecha de llegada.
`checkOutDate`requerido	AAAA-MM-DD	Fecha de salida.
`numGuests`requerido	integer 1-50	Nº de huéspedes esperado (el grupo puede ajustarlo).
`arrivalTime`	hh:mm	Hora de entrada (por defecto 16:00).
`departureTime`	hh:mm	Hora de salida (por defecto 11:00).
`source`	string	Canal de la reserva: airbnb, booking, direct…
`leadGuest`	objeto	{ name, email, phone } del huésped principal, para prellenar su registro.

curl

curl -X POST https://api.kinapi.es/api/v1/checkins \
  -H "ocp-apim-subscription-key: TU_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "reservationId": "R-2026-0412",
    "listingId": "38291",
    "confirmationCode": "HMXK4L",
    "checkInDate": "2026-08-14",
    "checkOutDate": "2026-08-18",
    "numGuests": 4
  }'

Idempotente: si el check-in ya existe, responde 200 con el existente (campo created: false) y la misma URL. Reintenta con libertad.

Listar check-ins

GET/checkins

Query

Campo	Tipo	Descripción
`from`	AAAA-MM-DD	Llegada desde (inclusive).
`to`	AAAA-MM-DD	Llegada hasta (inclusive).
`status`	string	Filtra por estado (ver tabla de estados).
`listingId`	string	Solo check-ins de ese listing.
`limit`	integer 1-200	Tamaño de página (por defecto 50).
`offset`	integer	Desplazamiento de paginación.

curl

curl "https://api.kinapi.es/api/v1/checkins?from=2026-08-01&to=2026-08-31&status=confirmed" \
  -H "ocp-apim-subscription-key: TU_API_KEY"

200 OK

{
  "results": [ { …check-in… }, … ],
  "hasMore": false
}

Consultar un check-in

GET/checkins/{reservationId}

Devuelve el check-in con el array guests incluido (mismo formato que el recurso Huéspedes).

curl

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

Actualizar un check-in

PATCH/checkins/{reservationId}

Body (todos opcionales)

Campo	Tipo	Descripción
`checkInDate`	AAAA-MM-DD	Nueva fecha de llegada.
`checkOutDate`	AAAA-MM-DD	Nueva fecha de salida.
`arrivalTime`	hh:mm	Nueva hora de entrada.
`departureTime`	hh:mm	Nueva hora de salida.
`numGuests`	integer 1-50	Nuevo nº de huéspedes esperado.

curl

curl -X PATCH https://api.kinapi.es/api/v1/checkins/R-2026-0412 \
  -H "ocp-apim-subscription-key: TU_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "checkOutDate": "2026-08-19" }'

Cancelar un check-in

DELETE/checkins/{reservationId}

Marca el check-in como cancelled: el enlace del huésped deja de aceptar registros y la reserva sale del envío a SES. No borra los datos ya registrados (auditoría).

curl

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