Integra en tu producto

Ficha completa del RUNT por placa: informacionGeneral (≈40 campos del vehículo), datosTecnicos, histórico completo de SOAT y de tecnomecánica (todas las vigencias, no solo la última), pólizas de responsabilidad civil, tarjeta de operación, blindaje, solicitudes, garantías mobiliarias, limitaciones a la propiedad y normalización. Desde 0.80.0 trae también las secciones que hasta ahora solo se veían en el portal del registro: desintegracion y certificadoDesintegracion (chatarrización: un certificado emitido significa que el vehículo no puede volver a circular), polizaCaucion, registroInicial y registroInicialInvc (autorización de registro inicial de vehículo nuevo de carga, y su variante del incentivo por reposición del 15%), certificadoDijin, informacionGps, informacionRepotenciado y permisosPcr. Son campos de cola larga: llegan en null salvo que el vehículo los tenga, y garantiasFavorDe pasa a traer el mismo contenido que garantiasMobiliarias porque es el rótulo con el que el registro los publica. Es la respuesta más extensa de la API: si solo necesitas marca/línea/modelo usa Vehículo básico. Fechas del registro: informacionGeneral.fechaMatricula (DD/MM/YYYY) y fechaRegistro (el mismo dato con la hora exacta, ISO 8601 con offset -05:00) describen cuándo quedó matriculado el vehículo, y diasMatriculado es el conteo de días transcurridos. Es la única fecha que existe del vehículo: no hay una fecha anterior a la matrícula (importación, improntas o reconocimiento previo), y los campos fechaExpedLTImportacion, fechaVenciLTImportacion y subpartida se emiten siempre pero llegan vacíos.

La MISMA ficha del RUNT que /api/consulta —informacionGeneral, datosTecnicos, histórico completo de SOAT y tecnomecánica, pólizas, solicitudes, garantías, limitaciones y normalización— pero entrando por VIN en vez de placa, y sin documento del propietario. Úsalo cuando tengas el VIN (o el número de chasis) pero no la cédula del dueño: la consulta por placa exige que el documento sea el del propietario ACTIVO y falla si no coincide. La respuesta trae la placa en data.plate, así que también sirve de puente VIN → placa. Único campo que cambia frente a /api/consulta: data.documentNumber viene vacío, porque no se pidió. Fechas del registro: informacionGeneral.fechaMatricula (DD/MM/YYYY) y fechaRegistro (el mismo dato con la hora exacta, ISO 8601 con offset -05:00) describen cuándo quedó matriculado el vehículo, y diasMatriculado es el conteo de días transcurridos. Es la única fecha que existe del vehículo: no hay una fecha anterior a la matrícula (importación, improntas o reconocimiento previo), y los campos fechaExpedLTImportacion, fechaVenciLTImportacion y subpartida se emiten siempre pero llegan vacíos.

Proyección liviana de la ficha del RUNT por placa: exactamente 12 campos — placa, marca, línea, modelo, cilindraje, color, clase, servicio, combustible, estado, fecha de matrícula y organismo de tránsito. Todos texto (fechaMatricula puede venir null). Respuesta mínima para apps que solo necesitan lo esencial; status siempre es info porque describe el vehículo sin calificarlo.

Semáforo SÍ/NO de si un vehículo está apto para traspaso, derivado del RUNT: sin gravámenes, prendas, limitaciones a la propiedad ni garantías, y con el registro activo. Devuelve el flag y la lista de bloqueos concretos en texto listo para mostrar. status es ok si está apto, danger si el bloqueo es un gravamen/prenda/limitación y warn si solo el estado no es ACTIVO.

Historial de reclamaciones ante aseguradoras de un vehículo (fuente FASECOLDA, desde 2008): fecha, amparo y severidad de cada registro. Solo pide la placa. severidad: "mayor" = la aseguradora indemnizó el vehículo completo (pérdida total); "menor" = indemnizó una reparación; "desconocida" = amparo que la fuente no cataloga. perdidaTotal es true SOLO si hay al menos un registro de severidad mayor, así que un carro con reclamaciones menores devuelve perdidaTotal: false con totalSiniestros > 0. Cobertura parcial: cubre únicamente vehículos que estuvieron asegurados, así que perdidaTotal: false significa «no figura», no «nunca chocó». La fuente no informa el valor indemnizado ni la aseguradora. status es danger con pérdida total, warn con reclamaciones menores y ok sin registros. Cuesta 2 créditos (la fuente topa las consultas diarias).

Accidentes de tránsito registrados por la autoridad de movilidad de Bogotá (informes IPAT) de un vehículo, por placa: fecha, gravedad (SOLO DAÑOS, CON HERIDOS, CON MUERTOS), número de formulario y código del informe, más recientes primero, con gravedadMaxima como resumen. Complementa a /api/perdida-total: esa fuente solo ve reclamaciones de vehículos asegurados y de mayor cuantía, mientras este registro incluye los choques sin heridos y no exige que el vehículo esté asegurado — a cambio cubre únicamente Bogotá. Una placa sin registros devuelve totalAccidentes: 0 y cobra: «no registra accidentes» es una respuesta definitiva. status es danger con heridos o muertos, warn con solo daños y ok sin registros. Cuesta 1 crédito.

Denuncias de hurto y demás procesos penales en los que quedó vinculado un vehículo, solo con la placa. Cada registro dice el papel del vehículo en el caso (categoria: hurto, receptacion —vehículo robado decomisado a quien lo tenía—, abuso_de_confianza, incautacion, accidente, usado_en_delito, otro), el tipo de vinculación literal, la fecha, el número de noticia criminal, el delito, el estado del caso (ACTIVO o INACTIVO con su motivo de archivo) y los datos del vehículo tal como quedaron en el caso, para cotejarlos con la ficha (una placa mal digitada en una denuncia cae sobre otra placa). Resume con reportadoHurto y denunciaHurtoActiva, e incluye procesos de extinción de dominio. status es danger con una denuncia de hurto activa, warn con cualquier otro registro y ok sin registros. Una placa sin registros cobra: es una respuesta definitiva, aunque no prueba que el vehículo nunca se haya robado (un robo recuperado sin denuncia no aparece). Cuesta 1 crédito.

Comparendos y deuda del SIMIT consolidados por placa + documento: une las multas del vehículo con las del documento enviado (también las de otras placas de esa persona, que le bloquean trámites como el traspaso), sin repetir ninguna. Devuelve el total adeudado en pesos, número de multas, el detalle de cada una (fecha, organismo, infracción, código, estado pendiente/acuerdo/pagada, valor, placa a la que está asociada y tipo: comparendo vigente o resolucion si ya escaló) y cuántos acuerdos de pago hay. Cada multa dice a quién está asociada: asociadaDocumento es true si la persona del documento es la infractora y false si la multa sale solo por la placa (otro conductor, un dueño anterior); asociadaPlaca es true si es de la placa consultada y false si es de esa persona en otro vehículo. Para quedarse con la deuda de la persona, filtrar por asociadaDocumento; con la del vehículo, por asociadaPlaca. El total consolida las dos clases a propósito e incluye lo pendiente de los acuerdos de pago; para la lista de solo comparendos vigentes está /api/comparendos. status: ok sin deuda, warn con deuda (multas o acuerdos pendientes) y danger si la deuda pasa de $1.000.000.

Toda la deuda de tránsito de una persona por cédula (fuente SIMIT) en una sola respuesta: sus comparendos, sus resoluciones sancionatorias —las multas en firme— y sus acuerdos de pago, cada bloque con su conteo, su subtotal y el detalle de cada ítem en la misma forma que entregan /api/comparendos, /api/resoluciones y /api/acuerdos-pago. Cuesta 2 créditos: pedir los tres por separado cuesta 3. totalDeuda es el total del estado de cuenta de la persona, la cifra con la que hay que comparar; no sumes los subtotales, porque una misma infracción puede figurar en dos bloques. pazSalvo es true solo si ese total es 0. Úsalo cuando la pregunta es si alguien debe algo: consultar solo los comparendos deja por fuera a quien debe una multa en firme o está pagando un acuerdo. status: ok sin deuda ni ítems, warn con deuda y danger si pasa de $1.000.000. Una persona sin deuda también es una consulta con datos y se cobra; la respuesta trae cost con lo cobrado (0 si salió de caché).

Comparendos de una persona por cédula (fuente SIMIT): lista tipada con fecha, organismo, infracción, código, estado, valor y departamento de cada comparendo, más el total adeudado. A diferencia de Multas SIMIT (que consolida por placa), este devuelve los comparendos de la persona. status: ok sin comparendos, warn con comparendos y danger si la deuda pasa de $1.000.000.

Detalle de un comparendo puntual: se busca por su número dentro de los comparendos de la persona (cédula) y se devuelve el item completo (fecha, organismo, infracción, código, estado, valor, departamento) o encontrado: false con comparendo: null si no figura. Ese caso también cobra: la consulta al SIMIT se hizo y la respuesta —que no aparece— es información. status: info si no se encontró, ok si está pagada, warn si no.

Acuerdos de pago de comparendos de una persona por cédula (fuente SIMIT): resolución, fecha, estado, valor del acuerdo, saldo pendiente, secretaría y departamento de cada uno, más el total pendiente. El SIMIT no publica el departamento del acuerdo, así que departamento viene "". status: ok sin acuerdos, warn con al menos uno.

Resoluciones sancionatorias asociadas a una persona por cédula (fuente SIMIT): las multas que ya tienen número de resolución, con fecha, organismo, infracción, código, estado, valor y departamento, más el total adeudado. status: ok sin resoluciones, warn con al menos una y danger si el total pasa de $1.000.000.

Certificado de paz y salvo de tránsito de una persona por cédula (fuente SIMIT): indica si está a paz y salvo (sin comparendos ni deuda pendiente), el total adeudado y la cantidad de comparendos. status es ok a paz y salvo, warn si no. Paso previo típico de un trámite. No sustituye el certificado oficial del organismo de tránsito.

Licencias de conducción por cédula (RUNT ciudadano): datos del conductor (nombre, estado de conductor y de ciudadano, número y fecha de inscripción), el arreglo licenses con una entrada por categoría —categoría, estado, número, organismo que expide, expedición, vencimiento, restricciones y, si aplica, resolución y fechas de suspensión— y los bloques de infracciones, solicitudes, certificados de aptitud y médicos, trámites SICOV, pagos ANSV, validaciones de identidad e impuestos de tránsito. Los bloques que el RUNT devuelve vacíos para la mayoría de documentos llegan como arreglos vacíos, no como null. Desde el 6-ago-2026 la fuente oficial exige el primerApellido del titular y devuelve el nombre ENMASCARADO (J**N P***Z). Acá el campo es OPCIONAL y define el precio: 1 crédito si envías el apellido, 2 si no lo mandas —en ese caso lo averiguamos por ti—. Si no lo mandas y tampoco se logra averiguar, la respuesta es 400 apellido_requerido y no cobra; si el registro de donde lo averiguamos no responde, es 503 identidad_no_disponible con Retry-After, que tampoco cobra. Dos aclaraciones: el status de cada categoría es el estado de la LICENCIA en el RUNT —por eso una categoría con la vigencia vencida puede decir ACTIVA; la fecha con la que se lee la vigencia es dueDate—, y infractions: null significa que esa sección del RUNT no se pudo consultar, no que la persona no tenga multas.

Estado de suspensión o cancelación de la licencia de conducción de una persona por cédula (fuente SIMIT): banderas suspendida/cancelada y, cuando aplica, la vigencia de la medida (fecha desde, fecha hasta y organismo de tránsito); sin medida los tres campos vienen null. status es danger si está suspendida o cancelada, ok si no. Crítico para agencias de licencias.

Valor comercial FASECOLDA por placa: código FASECOLDA, marca, línea, modelo (año), valor comercial en pesos, clase y la ficha técnica completa en fichaTecnica (38 campos: motor, dimensiones, capacidades, seguridad, equipamiento y clasificación — los mismos de /api/avaluo-por-codigo). El VIN y el modelo se resuelven primero desde el RUNT, así que la placa basta. origen dice cómo se identificó el vehículo: vin (exacto) o catalogo (marca + año + línea + cilindraje, cuando FASECOLDA no decodifica el chasis — le pasa a los modelos nuevos); con catalogo, aproximado avisa si quedó más de una versión posible y rangoMercado cubre todas. Por vin la versión es única, así que rangoMercado colapsa en el propio valor; la curva año por año de esa versión viaja aparte en valoresPorAnio. Valor de referencia del gremio asegurador, no un avalúo pericial: si una aseguradora cotiza otra cifra, lo primero a descartar es que haya tomado otra versión del mismo modelo. codigoFoto trae los identificadores de la imagen que la guía archiva para esa versión —lista vacía si no tiene ninguna—: el nombre del archivo no siempre corresponde al código, así que no se puede deducir.

Valor comercial FASECOLDA y ficha técnica completa por VIN (número de chasis), sin placa ni documento del propietario. Misma respuesta que /api/avaluo —código FASECOLDA, marca, línea, modelo (año), valor comercial en pesos, clase, fichaTecnica con sus 38 campos, valoresPorAnio y codigoFoto— pero entrando directo: FASECOLDA siempre se consultó por VIN, y en la versión por placa el documento del propietario existe solo para que el registro nacional devuelva ese número. Quien ya lo tiene a la vista se ahorra ese paso, su espera y su modo de falla más común (el documento que no corresponde al propietario activo). ⚠️ FASECOLDA no decodifica los VIN de los modelos nuevos (medido: ninguno de los 2025, uno de cada nueve de 2026). Para esos casos existe el respaldo por catálogo, que identifica el grupo compatible con marca + año + línea + cilindraje: por eso este endpoint acepta esos cuatro datos como campos opcionales. Mandarlos es la diferencia entre recibir un avalúo aproximado y no recibir ninguno en un vehículo 0 km; con un VIN que la fuente sí decodifica se ignoran. origen dice cuál de los dos caminos respondió (vin o catalogo) y, con catalogo, aproximado avisa si quedó más de una versión posible y rangoMercado las cubre todas. Valor de referencia del gremio asegurador, no un avalúo pericial. Un VIN que no resuelve por ningún camino responde data: null y no cobra. Cuesta 1 crédito por consulta con datos.

Valor comercial FASECOLDA directo por código, sin resolver placa→código. Para aseguradoras y peritos que ya tienen el código FASECOLDA. Acepta codeFasecolda y opcionalmente modelo (año) para desambiguar el valor. Devuelve además la ficha técnica completa del vehículo en fichaTecnica (38 campos, sin costo adicional): motor (cilindraje, potencia, combustible), transmisión y tracción, dimensiones y capacidades (peso, largo, ejes, puertas, pasajeros, carga), seguridad (airbags, ABS, frenos, dirección, faros) y equipamiento (aire acondicionado, sunroof, cámara de reversa, sensores, exploradoras, tapicería en cuero, vidrios/espejos/sillas eléctricas), más la clasificación del gremio (clase, categoría, tipología, servicio, nacionalidad, importado, segmento). ⚠️ En fichaTecnica, null significa la guía no publica ese dato para este vehículo, y es distinto de false (que sí es una afirmación: no lo tiene). Los campos planos históricos —categoria, tipologia, combustible, transmision, cilindraje— siguen viajando igual que siempre para no romper integraciones; en código nuevo, usar fichaTecnica. codigoFoto lista los identificadores de las imágenes que la guía tiene de esa versión (id y nombre de archivo), vacío cuando no hay ninguna. Se publica porque el nombre no se deduce del código: sobre 2.860 versiones medidas coincide con codigo en el 90,6% y con codigoHomologado en el 1,2%, pero en el 7,1% no es ninguno de los dos. Una versión puede traer dos entradas (la misma imagen en dos formatos, o dos imágenes distintas) y llegan en el orden de la guía, que no señala cuál es la principal.

Marcas, modelos, referencias y versiones de vehículos en Colombia, en cascada para poblar un selector: sin filtros trae las marcas y los años; con marca, sus referencias; con marca + modelo (o + referencia), las versiones. Cada versión trae su código —el mismo que acepta /api/avaluo-por-codigo—, el valor de mercado (valorUsado), el precio 0km (valorNuevo, solo en años que aún se venden nuevos) y la ficha técnica: los campos planos de siempre (cilindraje, potencia, airbags, puertas, tracción) más fichaTecnica, con los 38 campos completos de la guía y sus valores normalizados, y codigoFoto con los identificadores de su imagen (vacío si no hay). No pide placa ni documento del propietario. Cada lista viene null cuando su filtro ya está decidido; con listas=todas vuelven todas. Un filtro que no existe en el catálogo —o una combinación válida que no tiene ni una versión, como una marca que no vendió ese año— responde 404 consulta_sin_resultado; las primeras 10 de cada mes no cobran (ver /docs/errores).

Estado del impuesto vehicular por departamento. El departamento se resuelve desde el organismo de tránsito del RUNT por placa. En 22 departamentos (Antioquia, Arauca, Bogotá D.C., Bolívar, Boyacá, Caldas, Caquetá, Casanare, Cauca, Cesar, Córdoba, Guaviare, Huila, Magdalena, Meta, Norte de Santander, Putumayo, Risaralda, Santander, Sucre, Tolima y Valle del Cauca) data trae el histórico por vigencia en anios —año, valor, si está pagado y, cuando la fuente la publica, la fecha límite— más totalPendiente. En Cundinamarca la gobernación publica sus facturas oficiales por vigencia, pero no cuánto se debe hoy: data llega con deudaSinMonto cuando hay facturas sin pagar, o al día con vigenciasPagadas cuando la factura del año en curso existe y todas están pagadas. Nunca con un monto. Sin la factura del año en curso, data viene null. En el resto, data viene null y el valor está en portalUrl + el mensaje de error. `resultado` dice siempre en qué caso está la respuesta, para ramificar sin leer el texto. Con data (cobra 2): con_deuda, deuda_sin_monto, al_dia y sin_deuda_en_cobro. Sin data (no cobra): vehiculo_no_encontrado, documento_no_corresponde, no_sujeto (moto de hasta 125 cc o servicio público, Ley 488 de 1998, art. 141), sin_resultado (la entidad respondió y no tiene estado de cuenta que dar), sin_consulta_en_linea (solo portalUrl), departamento_no_identificado y fuente_no_disponible. El mismo campo viaja en el bloque impuestos de /api/consulta-full, que agrega no_consultado cuando no hubo ficha del vehículo. ⚠️ `deudaSinMonto: true` es deuda real. Algunos departamentos publican QUÉ vigencias se deben pero no cuánto: en ese caso totalPendiente llega en 0, las vigencias van en vigenciasAdeudadas y status es warn. No leas `totalPendiente: 0` como paz y salvo sin mirar `deudaSinMonto`. Nunca estimamos un monto que la fuente no dé. ⚠️ `sinDeudaEnCobro: true` tampoco es paz y salvo. Cuando la entidad afirma que esa placa no tiene deuda EN COBRO, data llega con sinDeudaEnCobro: true, totalPendiente en 0 y status info — nunca ok. Es un dato, pero acotado: puede haber una declaración pendiente o presentada con error que todavía no entra en cobro, y la advertencia viaja en error. 2 créditos, y solo cuando la fuente responde por la placa: cuenta con vigencias, deudaSinMonto o sinDeudaEnCobro. Si el departamento no tiene consulta en línea, o la fuente rechaza el documento o la placa, data viene null, el valor está en portalUrl + error, y se reembolsa. ℹ️ Cuando la entidad rechaza el documento o la placa, la respuesta trae además code (y errorCode, con el mismo valor) del contrato: propietario_no_coincide, vehiculo_no_registrado o consulta_sin_resultado. Va dentro de un `200`, no de un `404`: la respuesta sigue teniendo valor —el enlace al portal oficial— y este endpoint nunca cobra un sin-resultado. La única respuesta que no es 200 es fuente_no_disponible: `502` con code: source_error, como en el resto de la API; no cobra y reintentar sirve.

Restricción de pico y placa por ubicación y tipo de vehículo. Filtra por ciudad o por lat/lng (geolocaliza la ciudad; manda sobre ciudad). tipoVehiculo = carro (default) o moto. Qué dígito de la placa se evalúa lo fija el decreto de cada ciudad y viene en digitoPlaca: por defecto el último para carro y el primero para moto, pero no en todas: varias ciudades restringen también la moto por el último, así que hay que leer digitoPlaca en vez de asumir la regla. La placa es opcional: con placa indica si aplica hoy/mañana; sin placa devuelve qué dígitos restringen. Sin ubicación devuelve todas las ciudades monitoreadas. En festivo nacional no hay pico y placa en ninguna ciudad: digitosHoy sale vacío, hoyAplica en false y el bloque festivo trae el nombre del día. También viene incluido en consulta-full, con el mismo filtro por ubicación y el tipo de vehículo detectado solo desde el RUNT. Placa blanca: los vehículos de servicio público no reciben el pico y placa de particulares. Si no envías tipoVehiculo, el tipo se resuelve solo con la placa —primero con lo que ya sabemos del vehículo, y si hace falta consultando el registro—; deteccionServicio dice de dónde salió y vale no_determinado cuando no se pudo saber y se asumió carro.

Nombre completo del titular de un documento de identidad. Devuelve el nombre ya partido en partes, para no tener que adivinar del lado del cliente dónde termina el nombre y empieza el apellido. Consulta DOS registros en cascada: primero el registro social del DNP —instantáneo, y de regalo trae sexo, edad, municipio y departamento—, y si la persona no figura ahí cae al certificado de la Procuraduría, que cubre a cualquiera con documento colombiano pero tarda más. origen dice cuál respondió, así se sabe por qué unos campos vienen vacíos. Es el primer paso de cualquier verificación: confirmar que el documento existe y a quién pertenece antes de gastar consultas en antecedentes o en el vehículo. Un documento sin titular registrado responde 404 y NO cobra — a diferencia de los antecedentes, donde "no registra" sí cobra: acá el producto es el nombre, y si no vino no se entregó nada. Cuesta 1 crédito.

Clasificación socioeconómica de una persona por documento, de la Ventanilla Social del DNP. Devuelve el grupo del Sisbén IV (A pobreza extrema · B pobreza moderada · C vulnerable · D no pobre/no vulnerable) con su subgrupo y descripción, el grupo del RUI —el Registro Universal de Ingresos, la escala que reemplazó al Sisbén como criterio de focalización— y los datos básicos de la persona: nombre, sexo, edad, municipio y departamento. Sirve para verificar elegibilidad a subsidios y programas sociales. Una persona no registrada responde 404 y NO cobra. ⚠️ Nota de calidad que conviene conocer: el endpoint oficial del grupo Sisbén le asigna "D4 – no pobre, no vulnerable" a documentos que no existen; acá la existencia la decide el registro de ingresos y el grupo solo se publica si esa verificación pasó, así que un sisben: null significa "la persona existe pero no tiene grupo publicado", nunca un dato inventado. Cuesta 1 crédito.

Grupo del Registro Universal de Ingresos (RUI) de una persona por documento, de la Ventanilla Social del DNP: el nivel y el grupo de ingresos con los que hoy se decide el acceso a programas sociales. Es el mismo endpoint que `/api/sisben` y devuelve el mismo objeto —la fuente entrega las dos escalas juntas y aquí se entregan las dos—, así que da igual cuál se llame; existe con nombre propio porque el RUI reemplazó al Sisbén como criterio de focalización y quien trae una regla escrita en grupos del RUI no puede traducirla a grupos del Sisbén. Junto al RUI vienen el grupo del Sisbén IV y los datos básicos de la persona; el detalle de esa escala está en /api/sisben. Una persona no registrada responde 404 y NO cobra. ⚠️ La existencia del documento la decide el registro de ingresos y no el grupo del Sisbén: el endpoint oficial de ese grupo le asigna "D4 – no pobre, no vulnerable" a documentos que no existen, así que aquí un sisben: null significa "la persona existe y no tiene grupo publicado", nunca un dato inventado. Cuesta 1 crédito.

Dónde le toca votar a una persona, por cédula, del censo electoral de la Registraduría. Devuelve el puesto con su nombre oficial, la dirección, el número de mesa, el municipio y departamento, el código DIVIPOL del puesto —el mismo con el que la Registraduría publica logística y resultados— y las coordenadas del sitio con enlace de navegación, cuando la fuente lo tiene georreferenciado. Trae además fechaInscripcion, que es desde cuándo la persona figura en ese puesto: eso delata a quien acaba de trasladarse. No es estacional: consulta el lugar de votación vigente y responde también fuera de calendario electoral. Sirve para logística de transporte el día de elecciones, verificación de residencia electoral y validación de datos de afiliados. ⚠️ Solo cédula de ciudadanía — el censo electoral no maneja otro documento, y cualquier otro tipo responde 400 sin cobrar. Un documento que no figura en el censo responde 404 y NO cobra: acá el producto es el puesto, y si no vino no se entregó nada. La fuente distingue dos formas de "no hay puesto": que el documento no figure en el censo, y que tenga una novedad que lo saca de él (cédula cancelada por muerte, no expedida). Las dos responden 404 con el mensaje textual del registro y ninguna cobra: el estado de la cédula es otra pregunta, y no la vendemos como si fuera esta. Si el registro está limitando el tráfico en ese instante, la respuesta es 503 `fuente_saturada` con cabecera `Retry-After` y no cobra: no es una caída, es un cupo, y reintentar pasados esos segundos funciona. Cuesta 1 crédito.

Todas las afiliaciones de una persona al sistema de seguridad social, del RUAF del Ministerio de Salud, en UNA llamada: salud (EPS, régimen, tipo de afiliado y estado), pensiones (fondo y régimen), riesgos laborales (ARL), caja de compensación, cesantías, si está pensionada y a qué programas de asistencia social está vinculada. Responde "¿esta persona está cotizando hoy, dónde y por qué régimen?" — la pregunta de una vinculación laboral o un estudio de seguridad. Requiere la fecha de expedición del documento: la exige la fuente para autenticar, no nosotros. fechaCorte dice hasta cuándo están actualizados los datos, que NO es la fecha de la consulta: el Ministerio consolida con rezago. Cuesta 2 créditos — sustituye a siete consultas. ⏱️ Es de los más lentos del catálogo: cuenta con unos 10 segundos y picos de más, porque el informe lo genera un visor de reportes del Ministerio que no se puede apurar; conviene llamarlo de forma asíncrona y no dentro de una petición web con el usuario esperando. Una fecha que no coincide responde 404 y no cobra.

La afiliación en salud de una persona por documento, de la Base de Datos Única de Afiliados (BDUA) que administra la ADRES: la EPS, el régimen (contributivo o subsidiado), el estado (activo/retirado), el tipo de afiliado (cotizante, beneficiario, cabeza de familia) y las fechas de afiliación y finalización, junto con los datos básicos de la persona y su ciudad. Responde en segundos y no pide fecha de expedición del documento. afiliaciones trae el historial completo —una fila por traslado de EPS o cambio de régimen— y la fila ACTIVA es la afiliación vigente. Es la misma sección salud de /api/ruaf en versión puntual: aquella exige la fecha de expedición y cuesta 2 créditos con decenas de segundos de espera; esta responde "¿qué EPS tiene hoy?" por 1. ⚠️ La fuente enmascara la fecha de nacimiento (**/**/**), así que sale null. Una persona no registrada en BDUA responde 404 y NO cobra. Cuesta 1 crédito.

La inscripción de una persona en el Registro Único Nacional del Talento Humano en Salud (RETHUS) de MinSalud, por documento, sin fecha de expedición. Responde la pregunta puntual "¿está inscrito como profesional de la salud?" con los datos de la persona, su estado de identificación, las PROFESIONES registradas (título, acto administrativo, entidad reportadora) y las prestaciones de servicios de salud declaradas (lugar, modalidad, fechas). Responde en segundos y es el complemento del registro del profesional frente a la afiliación al sistema de /api/eps: una dice dónde está asegurada la persona, la otra si ejerce una profesión de la salud registrada. ⚠️ Los tipos de documento son los del registro: solo CC, CE, PT (protección temporal) y TI. primerNombre y primerApellido son opcionales (el registro no los exige) y se reenvían tal cual. Una persona sin inscripción responde 404 y NO cobra. Cuesta 1 crédito.

La afiliación a riesgos laborales de una persona en la ARL SURA —la administradora más grande del país— por documento, sin fecha de expedición. Devuelve el veredicto afiliado, el estado de la afiliación, el nombre del afiliado y el codigoValidacion del certificado oficial (validable por un mes en arlsura.com.co). Responde en segundos. Es la sección riesgosLaborales de /api/ruaf en versión puntual para una ARL: aquella exige la fecha de expedición y cuesta 2 créditos con decenas de segundos de espera; esta responde "¿está afiliado a ARL SURA?" por 1. ⚠️ No cubre las otras ARL (Positiva, Colmena…): para saber EN CUÁL está una persona, la respuesta completa es /api/ruaf. Una persona no afiliada a ARL SURA responde 404 y NO cobra (no es una negativa completa: SURA es una de varias ARL). Cuesta 1 crédito.

Antecedentes disciplinarios de una persona por documento, del sistema SIRI de la Procuraduría General de la Nación. Devuelve si registra sanciones o inhabilidades vigentes, el nombre completo del titular y el número del certificado para verificarlo ante la entidad. Cuando hay anotaciones vienen ESTRUCTURADAS —sanción, término, clase, delitos, providencia (autoridad y fechas) e inhabilidades con su vigencia—, no como bloque de texto. inhabilitadoHasta resume la fecha más lejana de todas: es lo que responde "¿puedo vincular a esta persona hoy?" sin recorrer el resto (un certificado real trajo 323 anotaciones, y anotaciones viene topada en 50 con el conteo real en totalAnotaciones). Sin antecedentes responde tieneAntecedentes: false — y esa respuesta también cobra: es el dato que se necesita para contratar o vincular a alguien. certificadoNumero y fechaExpedicion pueden venir vacíos: el veredicto sale del mismo registro por una vía que no expide el PDF, y se usa cuando la expedición está lenta o el registro ya agotó los certificados que emite al día para ese documento — así la respuesta llega en segundos en vez de fallar. Con refresh: true se vuelve a intentar el certificado. Cuando el veredicto es positivo, el detalle de las anotaciones sale siempre del certificado. Si el registro está limitando la consulta responde 503 `fuente_saturada` con cabecera `Retry-After` y NO cobra. Hay un caso en el que el registro responde 200 sin veredicto: cuando la Registraduría no reporta vigente el documento (cancelado por muerte, por doble cedulación o reemplazado), la Procuraduría no expide certificado pero sí informa quién es el titular y por qué. Ahí llegan documentoVigente: false, el motivo en estadoDocumento y `tieneAntecedentes: null`: null significa que el registro no se pronunció, así que no debe leerse como false. Cuesta 1 crédito.

Antecedentes fiscales de una persona natural por documento, del Boletín de Responsables Fiscales (SIBOR) de la Contraloría General de la República. Devuelve si está reportada como responsable fiscal y el código con el que se comprueba la autenticidad del certificado ante la entidad. Es el requisito para contratar con el Estado y para posesionarse en cargos públicos. Cuesta 1 crédito.

Antecedentes judiciales de una persona por documento, del sistema de la Policía Nacional. Certifica si la persona tiene asuntos pendientes con las autoridades judiciales HOY; por la Sentencia SU-458 de 2012 la consulta de terceros no revela condenas ya cumplidas o prescritas, así que no es un historial penal. descripcion trae la leyenda textual del registro, que tiene dos formas para el caso sin asuntos pendientes y no son intercambiables: conviene leerla, no solo la bandera. Devuelve además el nombre del titular en orden apellidos-nombres. `nombre` vacío es una señal, no un hueco: el registro omite esa línea cuando el documento no figura en la Registraduría. Cuesta 2 créditos: es el único endpoint de la familia que paga un resolvedor de captcha en cada consulta viva. Un hit de caché no cobra, y si la fuente falla se devuelven los 2.

Medidas correctivas pendientes por cumplir de una persona, del Registro Nacional de Medidas Correctivas (RNMC) creado por la Ley 1801 de 2016, el Código Nacional de Seguridad y Convivencia Ciudadana. Son las sanciones por comportamientos contrarios a la convivencia —riñas, consumo en espacio público, porte de armas blancas, ruido— y quedan pendientes hasta que la persona paga la multa o cumple la medida pedagógica. No es lo mismo que `/api/antecedentes-judiciales`: aquél son asuntos pendientes con autoridades JUDICIALES y éste sanciones de POLICÍA; una persona limpia en uno puede no estarlo en el otro, así que una verificación seria consulta los dos. Devuelve el veredicto, el nombre completo del titular sin enmascarar, el número de registro con el que se verifica el certificado ante la Policía —ese número lo imprime la Policía solo en el certificado SIN medidas; cuando el certificado trae medidas, ese campo viene vacío— y el texto oficial literal, listo para mostrar o imprimir. Requiere la fecha de expedición del documento: la exige la fuente para autenticar, no nosotros. Una respuesta "no tiene medidas" COBRA —es el dato que se vino a comprar—; una fecha que no coincide responde 404 y no cobra. ⚠️ Advertencia de cobertura que conviene conocer: el registro certifica "sin medidas correctivas" también para documentos que no existen, así que este veredicto no prueba que la persona exista; para eso está /api/cedula. Cuesta 1 crédito.

Búsqueda de una persona o empresa en las listas de sanciones de OFAC (Departamento del Tesoro de EE. UU.): la lista SDN —la "lista Clinton"— y las listas consolidadas no-SDN. Se consulta POR NOMBRE, no por documento: estas listas no manejan cédulas. Devuelve cada coincidencia con su puntaje 0–1, el programa de sanciones, la lista de origen y si el emparejamiento fue contra un alias (a.k.a.). La búsqueda cubre también los ~21.000 alias registrados, que es donde aparecen las variantes de escritura. Cuesta 1 crédito.

Notificaciones rojas públicas de INTERPOL por nombre. Nombres y apellidos van SEPARADOS porque la fuente los filtra por campos distintos; mandarlo todo junto en uno solo no encuentra nada. Devuelve cada notificación con su identificador oficial, fecha de nacimiento, nacionalidades y el enlace a la ficha pública. Cuesta 1 crédito. Hoy responde 503 `fuente_no_disponible` y no cobra: la fuente rechaza todas nuestras salidas de red y queda pendiente habilitar una que acepte.

Las cinco verificaciones de antecedentes de una persona en una sola llamada, cada una con su PDF para ver o descargar: disciplinarios (Procuraduría), fiscales (Contraloría), judiciales (Policía Nacional) y las listas de sanciones de OFAC y de la ONU. Procuraduría y Contraloría entregan el certificado original que expide la entidad (pdf.tipo: "oficial"), con su número o código de verificación. La Policía, OFAC y la ONU no expiden documento: para ellas el PDF es una constancia de consulta que emite PlacApi (pdf.tipo: "constancia") y dice que no reemplaza un certificado de la entidad. Basta con el documento: el nombre para buscar en OFAC y ONU se toma del registro, y se busca también en variantes cortas (primer nombre y apellidos) para que no se escape alguien listado con menos nombres; si mandas nombre, se usa ese. consultas permite pedir solo algunas. Cobro por consulta: 2 créditos con resultado y PDF, 1 con resultado sin PDF, 0 si falla o no aplica — 10 créditos las cinco completas, y la respuesta declara el total en cost. Tarda lo que la consulta más lenta: la Procuraduría expide el certificado en unos 7 s con el registro sano y hasta 140 s en un bache.

Empresas y comerciantes inscritos en las Cámaras de Comercio (el registro que el público consulta como "RUES"). Se busca por documento (NIT o cédula, vía exacta y recomendada) o por nombre. Devuelve razón social, matrícula, cámara, estado de la matrícula, tipo de sociedad, organización jurídica, códigos CIIU principal y secundario, fechas de matrícula, renovación, vigencia y cancelación, el último año renovado, si está inscrita como proponente y el representante legal con su documento. La búsqueda por nombre es de texto completo: "EL OSO" encuentra también "INVERSIONES ALTAMIRA EL OSO", y los resultados llegan por relevancia. resumen.totalCoincidencias es el conteo real en las dos vías. Cuesta 1 crédito, y cero coincidencias es un resultado válido que cobra.

Contratos de una persona o una empresa con el Estado colombiano, del SECOP II de Colombia Compra Eficiente. Se busca por documento (NIT o cédula) o por nombre del proveedor; el documento manda si llegan los dos. Devuelve un resumen agregado sobre el histórico completo —total de contratos, valor contratado, valor pagado, entidades distintas y conteo por estado— y una página de hasta 50 contratos con entidad, objeto, modalidad, valores y fechas. Es la respuesta a "¿este proveedor ya le ha contratado al Estado, a quién y por cuánto?", el dato que se pide en una debida diligencia. Sin contratos también responde 200 con datos y cobra: "no ha contratado con el Estado" es exactamente lo que se vino a comprobar. Cuesta 1 crédito.

Procesos judiciales de la Consulta de Procesos Nacional Unificada de la Rama Judicial. Se busca por radicado (23 dígitos) o por nombre de una de las partes, indicando si es persona natural o jurídica. Devuelve despacho, departamento, fechas y las partes procesales ya separadas por rol (la fuente las entrega en un solo texto plano). Consultando por radicado agrega además el detalle (ponente, tipo y clase de proceso, ubicación del expediente) y las últimas actuaciones con su anotación, que es lo que responde "en qué va el proceso" y no solo "existe". status es siempre info cuando hay procesos, nunca danger: la lista incluye tutelas, casos cerrados y procesos donde la persona es la DEMANDANTE. Cuesta 1 crédito. Por nombre, cero procesos es un resultado válido y cobra; un radicado que no existe responde 404 y no cobra.

Declaraciones de bienes y rentas y conflicto de interés (Ley 2013 de 2019) de servidores públicos y contratistas del Estado, del buscador ciudadano de la Función Pública. Se busca por documento o por nombre. Devuelve cada declaración con la entidad, el cargo, el motivo (ingreso, periódico o retiro), el número, la fecha de publicación y su estado, más un resumen con las entidades donde ha declarado. Responde "¿esta persona de verdad trabaja o contrata con el Estado, dónde y desde cuándo?". No entrega el PDF de la declaración: la descarga del portal sí valida captcha y no se puede automatizar; se devuelve idDeclaracion y portalUrl para bajarlo a mano. Cuesta 1 crédito, y "no tiene declaraciones publicadas" es una respuesta válida que cobra.

Prendas inscritas sobre un vehículo en el RGM de Confecámaras, por placa. Da el detalle que el RUNT a veces no entrega cuando solo marca la bandera: acreedor(es), deudor/garante (nombre y documento), folio electrónico, fecha de inscripción (formato del portal, dd/mm/aaaa hh:mm:ss) y última operación (inscripción, modificación, ejecución). Sin prendas responde tienePrenda: false con garantias: []. Cuesta 1 crédito.

La fecha probable de creación de una línea móvil colombiana. Responde en segundos, por número, sin documento ni titular. ⚠️ Es una fecha PROBABLE y una cota inferior: la línea existía en esa fecha o antes, y puede ser bastante más antigua. ⚠️ No todas las líneas tienen fecha: cuando no hay ninguna, fechaCreacionProbable llega en null y la consulta cobra igual —es una respuesta válida—. Cuesta 1 crédito.

La fecha probable de creación de un correo. Responde por email, sin documento ni titular. ⚠️ Es una fecha PROBABLE y una cota inferior: el correo existía en esa fecha o antes, y puede ser bastante más antiguo. ⚠️ No todos los correos tienen fecha: cuando no hay ninguna, fechaCreacionProbable llega en null y la consulta cobra igual —es una respuesta válida—. Cuesta 1 crédito.

Ficha técnica de un vehículo peruano por placa, desde el registro oficial de propiedad vehicular. Devuelve los 13 campos canónicos comunes a todos los países; en Perú el registro publica 5 de ellos y el resto llega en null, listados en cobertura.noPublicados. Una placa fuera del registro responde no_encontrado. No incluye datos del propietario. Cuesta 1 crédito.

Certificados de inspección técnica vehicular (CITV) de un vehículo peruano por placa: el equivalente a la tecnomecánica. Devuelve si hay un certificado vigente y hasta cuándo, y los tres certificados más recientes (es lo que publica el registro) con número, vigencia, resultado, estado, centro de inspección, tipo de servicio y observaciones. status es ok con certificado vigente, warn si solo hay historial vencido e info sin certificados. Una placa sin certificados es una respuesta válida (certificados vacío, vigente: false) y cobra. Cuesta 1 crédito.

SOAT (seguro obligatorio de accidentes de tránsito) de un vehículo peruano por placa, desde el registro central de las aseguradoras. Devuelve si hay una póliza vigente y hasta cuándo, la aseguradora que la emitió, y el histórico de pólizas (del más reciente al más viejo) con estado, vigencia (inicio y fin), número de póliza, código único, código SBS de la aseguradora, uso y clase del vehículo, marca, modelo, número de asientos y tipo de certificado. status es ok con póliza vigente, warn si solo hay historial vencido e info sin pólizas. Una placa sin SOAT registrado es una respuesta válida (certificados vacío, vigente: false) y cobra. No incluye datos del asegurado. Cuesta 1 crédito.

Papeletas de tránsito PENDIENTES de un vehículo peruano por placa, unidas de tres registros: el récord nacional de infracciones en carreteras (origen: "nacional"), las papeletas de Lima Metropolitana (origen: "lima") y las de la Provincia Constitucional del Callao (origen: "callao"). Devuelve el total, las pendientes, el monto pendiente en soles y cada papeleta con número, fecha, código y descripción de la infracción, gravedad, monto, estado y entidad. monto es la deuda viva: en Lima, importe + costas − descuento; en el Callao, el importe insoluto. El registro nacional no publica montos, así que ahí llega null y montoPendiente suma solo las que lo traen. descripcion es el texto de la infracción según el Reglamento Nacional de Tránsito y llega null cuando el código pertenece a otro reglamento; tipoRegistro es el rótulo con que el registro nacional clasifica el documento y nunca describe la infracción. Las pagadas no aparecen. El bloque cobertura dice cómo respondió cada registro (ok, sin_datos, error): si uno falla, los otros igual se entregan. status es warn con pendientes y ok sin ellas. Una placa sin papeletas es una respuesta válida y cobra. Cuesta 1 crédito.

Récord del conductor peruano por documento: licencias de conducir con número, clase y categoría, estado (VIGENTE o compuestos como CANCELADA/CONDUCTOR INHABILITADO), fechas de expedición y revalidación y restricciones, más las sanciones (resolución, fechas de inicio y fin, y estado derivado de esas fechas). No devuelve nombre ni datos de la persona: solo lo que describe la licencia. puntos llega siempre null: el registro no los publica. status es ok con licencia vigente, warn con cualquier otro estado o sanción vigente e info sin licencia. Un documento sin licencia es una respuesta válida (tieneLicencia: false) y cobra; un DNI que no tenga exactamente 8 dígitos responde 400 consulta_invalida sin cobrar. Cuesta 1 crédito.

Multas de tránsito y sanciones de un vehículo de la Ciudad de México por placa, desde la consulta pública de adeudos de la Secretaría de Administración y Finanzas de la CDMX. Devuelve las infracciones de tránsito (con folio, fecha, situación, motivo, fundamento del reglamento y sanción en unidades de cuenta) y las sanciones de medio ambiente, más la tenencia año por año. El registro publica HISTORIAL: las pagadas vienen con situacion: "Pagada", y infraccionesPendientes / sancionesPendientes son el corte vivo. La sanción está en UMA (unidades de cuenta), no en pesos: el portal no lo convierte en esta respuesta. Una placa que el padrón de la CDMX no reconoce responde encontrado: false (cobertura: solo vehículos emplacados en la CDMX). status es warn con deuda pendiente y ok sin ella. Una placa sin multas es una respuesta válida y cobra. Cuesta 1 crédito.

Verificación vehicular de la Ciudad de México por placa: el equivalente mexicano de la tecnomecánica. Devuelve si el vehículo puede tramitar el holograma de verificación (puedeVerificar, la MISMA regla del portal: sin adeudos de tenencia, sin pérdida del derecho y con puntaje de fotocívicas íntegro), el puntaje de fotocívicas con su mensaje, las sanciones de medio ambiente que incluyen las de holograma (circular sin holograma vigente) y la vigencia de la tarjeta de circulación. Una placa que el padrón de la CDMX no reconoce responde encontrado: false (cobertura: solo vehículos emplacados en la CDMX). status es ok si puede verificar, warn si tiene un adeudo que se lo impide e info sin señales o fuera del padrón. Una placa sin problemas es una respuesta válida y cobra. Cuesta 1 crédito.

Vigencia de la licencia de conducir de la Ciudad de México por CURP, desde el portal de finanzas de la CDMX. Devuelve si el registro reporta vigencia para esa CURP y la vigencia tal como la publica el portal. ⚠️ No es el registro nacional de licencias — México no tiene uno público — y la respuesta negativa del portal agrupa dos cosas: sin datos en CDMX O licencia permanente (el programa 2024+, que no tiene vigencia). Por eso encontrada: false no afirma que la persona no tenga licencia: solo que la ciudad no reporta una vigencia, y el mensaje del portal viaja completo. Una CURP mal formada responde 400 sin cobrar. status es ok con vigencia reportada e info sin ella (respuesta válida que cobra). Cuesta 1 crédito.

Ficha de un vehículo chileno por patente, con el mismo contrato de trece campos que Perú y México. Devuelve tipo, marca, línea, año, VIN y si el vehículo está o estuvo inscrito como transporte público o escolar (servicioPublico), más tres extras que Chile sí publica: el sello de emisiones, el número de motor y el de chasis. Los siete campos que los registros chilenos no publican llegan en null y quedan enumerados en cobertura.noPublicados, para distinguir "este vehículo no tiene el dato" de "Chile no publica ese dato". servicioPublico llega en null —no en false— si ese registro no respondió. No incluye datos del propietario. Cuesta 1 crédito.

Revisión técnica de un vehículo chileno por patente, desde la base central que consolida todas las Plantas de Revisión Técnica del país. Devuelve si hay una revisión vigente y hasta cuándo, la ficha del vehículo (tipo, marca, modelo, año, motor, chasis y tipo de sello) y el historial completo de revisiones con fecha, planta, número de certificado, vencimiento y estado. Cada revisión aprobada aparece dos veces —tipo: "mecanica" y tipo: "gases"—: son las dos pruebas del mismo certificado y una puede faltar. vigenteHasta se entrega también cuando ya venció, para responder desde cuándo. status es ok con revisión vigente, warn si solo hay historial vencido e info sin revisiones. Una patente sin revisiones es una respuesta válida y cobra. Cuesta 1 crédito.

Valida el SOAP (seguro obligatorio) de un vehículo chileno contra el registro de las aseguradoras. Pide dos datos: la patente y los últimos cuatro dígitos de la póliza, porque el registro chileno los cruza y sin los dos no responde: no es una consulta por patente, es la verificación de un certificado que ya se tiene. Devuelve si el par existe en el registro (encontrado), si además sigue vigente (vigente), la aseguradora que lo emitió y el periodo de vigencia. Cuando el par existe entrega además el certificado completo: número de póliza, folio, prima, la ficha del vehículo asegurado (tipo, marca, línea, año y número de motor) y el dígito verificador de la patente, que es el que pide el detalle de multas chileno. status es ok con certificado vigente, warn si existe pero venció e info si el registro no reconoce ese par — esa última es la respuesta que delata un certificado falso, es un hallazgo válido y cobra. Se acepta el número de póliza completo: se toman sus cuatro últimos dígitos. No incluye datos del asegurado. Cuesta 1 crédito.

Multas de tránsito de un vehículo chileno por patente, unidas de tres registros: el detalle con importes de los Juzgados de Policía Local de todo el país (origen: "detalle"), el consolidado nacional de multas no pagadas (origen: "nacional") y las infracciones detectadas por cámaras en los últimos 60 días, que todavía no llegan al juzgado (origen: "camaras"). Devuelve el total, las pendientes, el monto pendiente en pesos y cada multa con juzgado, comuna, rol de la causa, fecha, monto, infracción y número de denuncia. El monto es multa + arancel, que es lo que se paga en ventanilla. Los dos primeros registros listan las mismas causas y se cruzan por el rol, así que ninguna aparece dos veces; una causa que solo está en el consolidado llega sin monto. Trae además permisoCirculacion, con las multas registradas al corte del 30 de noviembre y si eso bloquea el permiso del año siguiente, que es la pregunta comercial real. El bloque cobertura dice cómo respondió cada registro (ok, sin_datos, error): si uno falla, los otros se entregan igual, y si el consolidado nacional no respondió el status nunca es ok. No incluye datos del propietario. Cuesta 1 crédito.