PlacApi

Referencia abierta · OpenAPI 3.1

Una placa entra. El historial completo sale en JSON.

Consultar el RUNT en Colombia hoy significa resolver un captcha, y repetirlo en otros cuatro portales para el SOAT, las multas, el impuesto y el avalúo. PlacApi lo resuelve en una llamada REST. Esta es su especificación, abierta y sin registro.

Colombia
ABC123

POST /api/consulta

200 OK · 1 crédito
{
  "plate": "ABC123",
  "informacionGeneral": {
    "marca": "MAZDA",
    "linea": "CX-30",
    "modelo": "2023",
    "cilindraje": "2000",
    "estadoDelVehiculo": "ACTIVO",
    "organismoTransito": "SDM BOGOTA",
    "tieneGravamenes": "NO"
  },
  "soat": { "vigente": true, "diasRestantes": 213 },
  "tecnomecanica": { "vigente": true }
}

Qué se puede consultar

36 endpoints, todos POST, todos con respuesta JSON. Se agrupan por lo que verifican: el vehículo, el conductor, la persona o la empresa.

Reporte completo

1

Todas las fuentes del vehículo y del propietario en una sola llamada.

  • consulta-full

Vehículo (RUNT)

5

Ficha, estado y verificación del vehículo por placa o por VIN.

  • consulta
  • consulta-por-vin
  • vehiculo-basico
  • apto-traspaso
  • perdida-total

Multas y comparendos (SIMIT)

6

Comparendos, resoluciones, acuerdos y paz y salvo por placa o cédula.

  • multas
  • comparendos
  • comparendo
  • acuerdos-pago
  • resoluciones
  • paz-salvo

Licencias de conducción

2

Licencias del conductor y suspensiones o cancelaciones por cédula.

  • licencia
  • suspension-licencia

Avalúo comercial (FASECOLDA)

3

Valor comercial de referencia por placa o por código FASECOLDA.

  • avaluo
  • avaluo-por-codigo
  • catalogo

Impuestos y movilidad

2

Impuesto vehicular y restricción de pico y placa en 30 ciudades.

  • impuestos
  • pico-y-placa

Prendas y garantías

1

Garantías mobiliarias inscritas sobre el vehículo (RGM).

  • garantias-rgm

Antecedentes de personas

10

Verificación de una persona, no de un vehículo: identidad, clasificación social, seguridad social, puesto de votación, disciplinarios, fiscales y judiciales.

  • cedula
  • sisben
  • rui
  • puesto-votacion
  • ruaf
  • antecedentes-disciplinarios
  • antecedentes-fiscales
  • antecedentes-judiciales
  • listas-restrictivas
  • notificaciones-internacionales

Empresas y Estado

4

Debida diligencia sobre la contraparte: registro mercantil, contratación estatal, procesos judiciales y declaración de bienes y rentas.

  • rues
  • secop
  • rama-judicial
  • sigep

Fuera de Colombia

2

Consulta vehicular en Perú y México. Cobertura menor que la colombiana.

  • vehiculo-pe
  • vehiculo-mx

Arranque

Autenticación por cabecera x-api-key. Servidor https://placapi.com/api. Sin SDK obligatorio: es HTTP y JSON.

Con curl
curl -X POST 'https://placapi.com/api/consulta' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"placa":"ABC123","docType":"CC","docNumber":"1020304050"}'
Con fetch, sin instalar nada
const r = await fetch('https://placapi.com/api/consulta', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.PLACAPI_KEY,
    'content-type': 'application/json'
  },
  body: JSON.stringify({
    placa: 'ABC123', docType: 'CC', docNumber: '1020304050'
  })
})

const { data } = await r.json()
console.log(data.informacionGeneral.marca) // MAZDA
Prepago por consulta, sin cuota mensual. consulta-full cuesta 2 créditos; el resto, 1. Repetir la misma consulta dentro de la ventana de caché no vuelve a cobrar. Una consulta sin resultado (404) trae 10 gratis al mes por cada código de sin-resultado; a partir de ahí cobra como una normal. El límite es de 1.000 consultas por minuto por clave. Tarifas vigentes en placapi.com/comprar.

Repositorios

Todo lo de esta página es abierto y se puede clonar.

placapi-openapi

Especificación OpenAPI 3.1 y colección de Postman. Genera un cliente en cualquier lenguaje.

placapi-node

Cliente oficial para Node.js y TypeScript. Envoltorio sobre fetch, sin dependencias.

runt-simit-colombia

Guía de referencia sobre qué publica de verdad cada fuente oficial colombiana, y qué no.