API de Kinapi
Automatiza el registro de viajeros de tus reservas: una API REST para crear check-ins, seguir su estado y recuperar contratos y partes a SES Hospedajes.
Cómo funciona
El modelo es deliberadamente simple: tu software crea un check-in por cada reserva y recibe una URL. Esa URL se envía al huésped (por email, WhatsApp o tu propio canal) y todo lo demás ocurre dentro de Kinapi: cada huésped rellena sus datos (validados contra las reglas de SES), firma el contrato, y la noche de la llegada el parte de viajeros se comunica automáticamente a SES Hospedajes.
Tu integración puede ser tan simple como una llamada (crear check-in) o hacer un seguimiento completo: consultar huéspedes registrados, descargar el contrato firmado y verificar las confirmaciones del Ministerio.
Base URL
https://api.kinapi.es/api/v1
Todas las peticiones van por HTTPS y usan JSON en cuerpo y respuesta. La autenticación es por API key — ver Autenticación.
Especificación OpenAPI
Toda la API está descrita en un fichero OpenAPI 3.0, generado de los mismos esquemas que validan cada petición: no puede ir por detrás del código. Con él generas un cliente en tu lenguaje (openapi-generator, openapi-typescript…), lo importas en Postman o Insomnia, o lo pruebas desde el navegador en Swagger UI. Está en inglés, como los generadores que lo leen.
https://www.kinapi.es/openapi.json
En Postman: Import → Link y pega la URL. Cada operación llega con su cuerpo, sus respuestas y sus códigos de error; solo tienes que poner tu API key en la cabecera ocp-apim-subscription-key.
Primera llamada en 30 segundos
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
}'{
"reservationId": "R-2026-0412",
"status": "pending",
"url": "https://checkinsas…/c/aGb3xKf9…",
"created": true
}Recursos
Check-ins
Crear, listar, consultar, actualizar y cancelar el check-in de cada reserva.
Huéspedes
Registrar viajeros desde tu sistema, consultarlos y ver el estado de su firma.
Propiedades
Alta y gestión de alojamientos y códigos de establecimiento SES.
Propietarios
Titulares de los alojamientos: datos fiscales que salen en el contrato.
Contratos
Configurar qué dice el contrato con plantillas, y descargar el PDF firmado y el parte de viajeros.
SES Hospedajes
Estado del parte de viajeros, envío inmediato y catálogos oficiales.
Credenciales SES
Un conjunto por arrendador, asignable por propiedad, con prueba de conexión.
Facturación
Consumo del mes, coste estimado e histórico por meses.
Webhooks
Recibir avisos en tu sistema cuando ocurre algo, con firma verificable.
Configuración de la cuenta
Ajustes, marca blanca del formulario y gestión del webhook por API.
Exportación y fin del servicio
Los registros de un titular o de la cuenta en un ZIP, la baja de un titular y la de la cuenta.
¿Prefieres que lo use un agente en vez de escribir el cliente?
kinapi-mcp-server expone esta misma API como herramientas MCP: Claude (u otro agente compatible) crea check-ins, consulta su estado y descarga contratos hablando directamente con Kinapi, sin que le escribas un cliente HTTP.