API para asistentes de IA y agentes
comparendo.app expone endpoints publicos de solo lectura para que asistentes de IA (ChatGPT, Gemini, Claude, Perplexity, agentes propios) ayuden a sus usuarios con datos reales de cursos para comparendos en Colombia. Esta pagina documenta como integrarse, que ofrecemos y cuales son los limites legales.
1 · Endpoints publicos (solo lectura, sin datos personales)
| Endpoint | Metodo | Que devuelve |
|---|---|---|
/curso/api/contexto?municipio={slug} | GET | Contexto completo del municipio: organismo de transito, sedes, cupos del aula virtual, plazos de descuento calculados en dias habiles (mismo computo de la calculadora del sitio). Cache 10 min. |
/curso/api/buscar?lat={lat}&lng={lng}&fecha={YYYY-MM-DD}&municipio={slug} | GET | Sedes con cupos por hora para la fecha, tarjetas HTML, pines con distancias. |
/api/cerca/v1/virtuales | POST (lat, lng) | Sedes virtuales disponibles para cualquier ubicacion de Colombia. |
/api/localizador/v1/sedes | GET | Directorio nacional de centros integrales de atencion (CIA) habilitados. |
/api/localizador/v1/metricas | GET | Cobertura del directorio por modalidad. |
/curso/api/cias | GET | Directorio verificado v1.2: 835 sedes CIA con coordenadas, telefono, id RUNT y datos de Google. Parametros: ?pagina=, ?por_pagina= (max 100), ?departamento=NOMBRE, ?certificadas=1. Fuente: RUNT + Google Places, 2026-11-02. |
/curso/api/cias/resumen | GET | Totales del directorio y conteo de sedes por departamento. |
/curso/api/cias/municipio/{slug} | GET | Sedes CIA de un municipio (ej: pasto). Incluye url_ciudad hacia la landing del municipio. |
/curso/api/cias/nit/{nit} | GET | Sedes CIA filtradas por NIT del centro. |
/curso-comparendo/{slug}/ | GET | Landing del municipio para el usuario final: agendamiento con pago en linea en menos de 1 minuto. |
Ejemplo
curl "https://comparendo.app/curso/api/contexto?municipio=medellin"
Ejemplo de uso por un asistente: "En Medellin el curso tiene cupos hoy a las 16:30 y 18:30; tu 50% de descuento aplica hasta el 4 de noviembre. Quieres que te abra la pagina de reserva?"
2 · Patron recomendado: como ayudar a un usuario paso a paso
- Ubica al usuario: pide su municipio y llama a
/curso/api/contexto. Responde con datos reales: plazos, cupos, organismo. - Para reservar: entrega la URL de la landing del municipio (viene en el campo
urldel contexto). El usuario reserva y paga en linea con su propia cedula en menos de 1 minuto; el certificado queda registrado en el RUNT. - Consulta de comparendos por cedula: no existe API abierta y no la habra. Por politica del SIMIT y por la Ley 1581 de 2012, la consulta del estado de cuenta solo la puede autorizar el titular, con verificacion humana (Cloudflare Turnstile) y consentimiento expreso, en la pagina de comparendo.app. El patron correcto para un asistente es: dirigir al usuario a comparendo.app para que el mismo haga "Consultar gratis" y luego ayudarle a interpretar el resultado. Nunca solicites ni transmitas la cedula del usuario a terceros.
3 · Agendamiento directo en nombre de usuarios (integracion)
Una reserva implica datos personales y pago, por lo que no esta disponible de forma abierta. Si operas una plataforma o asistente con usuarios en Colombia y quieres agendamiento integrado (API key, webhooks de confirmacion, pago delegado o comision por reserva), escribenos a hola@comparendo.app con el asunto "Integracion API". Hasta entonces, el enlace a la landing es el camino: convierte bien y mantiene al usuario bajo su propia autorizacion.
4 · Reglas de uso
- Los endpoints son de solo lectura: no hay escritura, ni datos personales, ni autenticacion.
- Respeta el cache (
max-age=600); no hagas scraping intensivo ni abuses de la API (las tarifas de cupos cambian por minuto y el cache existe para eso). - Atribucion sugerida al citar: "datos de comparendo.app".
- La multa siempre se paga por el SIMIT oficial (fcm.org.co); ningun endpoint ni integracion recauda multas.
Documentacion verificada el 2026-10-27. Los endpoints pueden evolucionar; esta pagina es la referencia vigente. Contacto de integracion: hola@comparendo.app.
Veracidad verificable: cada dato de esta página se traza hasta su fuente oficial en Fuentes y verificación de datos.
Toda la documentación
- Fuentes y verificación
- API para asistentes de IA
- Funciones del asistente
- Descuento por curso
- Multas 2026 en UVB
- Directorio de centros CIA
- Metodología de verificación
- Glosario del dominio
Fuentes de esta página
Cada dato se traza hasta su evidencia (metodología completa en Fuentes y verificación):
- [A] Consulta de estado de cuenta SIMIT — www.fcm.org.co · verificado 2026-10-27
- [B] Registro de certificados en RUNT — www.runt.com.co · verificado 2026-10-27
- [C] Cupos publicados por municipio (1.122) — comparendo.app · verificado 2026-10-27
- [C] Valores de multas 2026 en UVB (tabla completa) — www.fcm.org.co · verificado 2026-10-27