Endpoint: consulta vehicular

Con la placa y el documento del propietario devuelve la ficha del vehículo en el RUNT: datos generales y técnicos, histórico de SOAT y tecnomecánica, pólizas de responsabilidad civil, garantías, limitaciones y solicitudes. Las multas SIMIT, el impuesto, el avalúo FASECOLDA y el pico y placa tienen sus propios endpoints. Es el endpoint por defecto para 'dame los datos de esta placa': trae la ficha del RUNT con su histórico de SOAT y de tecnomecánica en un solo objeto. Si además necesitas las multas del SIMIT, el impuesto, el avalúo y el pico y placa en la MISMA llamada, eso es /api/consulta-full y cuesta 2 créditos; si te sobra la mitad de los campos, /api/vehiculo-basico devuelve doce y cuesta lo mismo que este. Los tres consultan al RUNT igual: lo que cambia es cuánto se junta y cuánto se devuelve.

POST/api/consulta1 crédito

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. Es la respuesta más extensa de la API: si solo necesitas marca/línea/modelo usa Vehículo básico.

Cuerpo de la solicitud

body (JSON)
{
  "placa": "ABC123",
  "docType": "CC",
  "docNumber": "1020304050"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
placaobligatoriostringPlaca del vehículo. 5 a 7 caracteres alfanuméricos: cubre AAA000, AAA00A y los formatos menos comunes (AAA00, AAAA00). Los guiones y espacios se ignoran.
docTypeobligatoriostringTipo de documento del propietario (CC, CE, NIT, PA, TI, CD, PPT, RC). Se aceptan alias comunes: PAS y PASAPORTE se normalizan a PA, y P.P.T. y P.P. —como lo abrevia la tarjeta de propiedad— se normalizan a PPT.Valores: CC · CE · NIT · PA · TI · CD · PPT · RC
docNumberobligatoriostringNúmero de documento del propietario. Alias aceptado: `doc`.
refreshbooleanIgnora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).
formatstring`complete` (default) incluye `data.plate`; `vehicle-by-plate` lo omite para dejar el shape RUNT puro.

Ejemplos por lenguaje

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"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/consulta", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"placa":"ABC123","docType":"CC","docNumber":"1020304050"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/consulta",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"placa":"ABC123","docType":"CC","docNumber":"1020304050"},
)
data = res.json()

Respuesta exitosa

200 OK — datos ficticios de ejemplo
{
  "data": {
    "documentNumber": "1020304050",
    "plate": "ABC123",
    "vin": "9GAJC6915FB040270",
    "informacionGeneral": {
      "capacidadCarga": null,
      "cilindraje": "2000",
      "claseVehiculo": "CAMIONETA",
      "clasificacion": "VEHICULO PARTICULAR",
      "color": "ROJO",
      "diasMatriculado": "1227",
      "esRegrabadoChasis": "NO",
      "esRegrabadoMotor": "NO",
      "esRegrabadoSerie": "NO",
      "esRegrabadoVin": "NO",
      "estadoDelVehiculo": "ACTIVO",
      "fechaExpedLTImportacion": "",
      "fechaMatricula": "15/03/2023",
      "fechaVenciLTImportacion": "",
      "idTipoServicio": "1",
      "linea": "CX-30",
      "marca": "MAZDA",
      "modelo": "2023",
      "mostrarSolicitudes": "NO",
      "noChasis": "9GAJC6915FB040270",
      "noEjes": "2",
      "noIdentificacion": null,
      "noLicenciaTransito": "12345678",
      "noMotor": "MTR0000001",
      "noPlaca": "ABC123",
      "noSerie": "9GAJC6915FB040270",
      "noVin": "9GAJC6915FB040270",
      "nombrePais": null,
      "organismoTransito": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA",
      "pasajerosSentados": "5",
      "pasajerosTotal": null,
      "pesoBruto": "1650",
      "prendas": "NO",
      "puertas": "5",
      "repotenciado": "NO",
      "seguridadEstado": "NO",
      "subpartida": null,
      "tarjetaServicio": "NO",
      "tieneGravamenes": "NO",
      "tieneLTImportacion": false,
      "tipoCarroceria": "WAGON",
      "tipoCombustible": "GASOLINA",
      "tipoMaquinaria": null,
      "tipoServicio": "Particular",
      "validacionDIAN": "Exitoso",
      "vehiculoEnsenanza": "NO",
      "verValidaDIAN": true
    },
    "datosTecnicos": {
      "capacidadCarga": null,
      "pesoBrutoVehicular": null,
      "noEjes": null,
      "noLlantas": null,
      "alto": null,
      "ancho": null,
      "largo": null,
      "pasajerosTotal": null,
      "pasajerosSentados": null,
      "rodaje": null,
      "peso": null
    },
    "soat": [
      {
        "entidadExpideSoat": "SBS SEGUROS",
        "estado": "VIGENTE",
        "estadoSoat": "VIGENTE",
        "fechaExpediSoat": "20/09/2025",
        "fechaExpedicion": "20/09/2025",
        "fechaVencimiento": "19/09/2026",
        "fechaVigencia": "20/09/2025",
        "noPoliza": "1508006948335000",
        "nombrePais": null,
        "origen": "EXPEDICION",
        "placa": "ABC123",
        "tipoTarifa": "TARIFA PLENA"
      }
    ],
    "tecnoMecanica": [
      {
        "cdaExpide": "CDA FONTIBON S.A.S",
        "estado": "APROBADA",
        "fechaExpedicion": "22/09/2025",
        "fechaVencimiento": "22/09/2026",
        "informacionConsistente": "SI",
        "nroCertificado": "189733821",
        "numeroPlaca": "ABC123",
        "tipoRevision": "REVISION PERIODICA",
        "url": "d4ef5ac5-6c14-4185-b382-98a204ac6fa7",
        "vigente": "SI"
      }
    ],
    "polizasResponsabilidadCivil": [],
    "tarjetaOperacion": null,
    "informacionBlindaje": {
      "autorizacion": null,
      "blindado": null,
      "fechaBlindaje": null,
      "fechaDesblindaje": null,
      "fechaExpedicionCertificado": null,
      "fechaExpedicionCertificadoFormatoWS": null,
      "idDocumentoCertificadoBlindaje": null,
      "nivelBlindaje": null,
      "nivelBlindajeNumero": null,
      "numeroResolucion": null,
      "tipoBlindajeNombre": null
    },
    "solicitudes": [],
    "garantiasMobiliarias": [],
    "garantiasFavorDe": [],
    "limitacionPropiedad": [],
    "normalizacionSaneamiento": []
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z"
}

Errores y cobro

Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.

Última revisión: 11 de julio de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto