# Webhooks

> **No documentados públicamente.**
>
> El OpenAPI actual del API de Chapi (`v0.0.1`, mayo 2026) **no expone endpoints de webhooks**. Los 4 endpoints públicos son síncronos: la respuesta llega en la misma llamada HTTP.
>
> Si tu integración necesita ser notificada de eventos (por ejemplo, cuando un Check pasa de `low` a `high`, o cuando se actualiza una causa judicial), contacta a Chapi vía [https://chapi.cl/contacto](/contacto) para discutir alternativas.

## Patrón actual: polling

Mientras no haya webhooks, el patrón soportado para mantener un Check actualizado es **polling**:

1. Crea o reutiliza un Check con `POST /api/check`.
2. Recupera periódicamente con `GET /api/check/{rut}`.
3. La cadencia recomendada depende del caso de uso (procesos de onboarding suelen necesitar minutos; monitoreo continuo puede ser diario).

Recordatorio: dentro de un mismo mes calendario, `POST /api/check` devolverá el mismo `id` para el mismo RUT.

## Pendiente de aclaración

> **Roadmap de webhooks.** No hay declaración pública sobre si Chapi planea exponer webhooks. Esta página se actualizará cuando exista soporte oficial.

---

Última actualización: 2026-05-01