Endpoint: consulta vehicular

Con la placa y el documento del propietario devuelve, en una sola llamada, el resultado combinado de las fuentes vehiculares de Colombia.

POST/api/consulta

Vehículo, SOAT, tecnomecánica (RTM), antecedentes, multas SIMIT, impuestos, avalúo Fasecolda y pico y placa — en una sola llamada.

Autenticación

API key en el header x-api-key: pk_live_… (o Authorization: Bearer pk_live_…). Genera tu clave en el sandbox.

Cuerpo de la solicitud

body (JSON)

{
  "placa": "ABC123",
  "docType": "CC",
  "docNumber": "1020304050"
}

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

{
  "vehicle": {
    "source": "RUNT",
    "status": "ok",
    "data": {
      "placa": "ABC123",
      "marca": "MAZDA",
      "linea": "CX-30",
      "modelo": 2023,
      "cilindraje": 2000,
      "combustible": "GASOLINA",
      "servicio": "PARTICULAR",
      "clase": "CAMIONETA",
      "estado": "activo"
    }
  },
  "soat": {
    "status": "ok",
    "data": {
      "vigente": true,
      "aseguradora": "SBS SEGUROS",
      "fechaVencimiento": "2026-09-19",
      "diasParaVencer": 71
    }
  },
  "rtm": {
    "status": "ok",
    "data": {
      "vigente": true,
      "exento": false,
      "fechaVencimiento": "2026-09-22",
      "diasParaVencer": 74
    }
  },
  "antecedentes": {
    "status": "ok",
    "data": {
      "prendas": 0,
      "embargos": 0,
      "historicoPropietarios": 2
    }
  },
  "simit": {
    "status": "ok",
    "data": {
      "tieneMultas": false,
      "totalDeuda": 0
    }
  },
  "picoYPlaca": {
    "status": "ok",
    "data": {
      "hoyAplica": false
    }
  }
}

Códigos de error

Código	Significado
401	No autenticado o API key inválida.
402	Sin créditos suficientes para la consulta.
422	Cuerpo inválido (placa o documento con formato incorrecto).
429	Rate limit: demasiadas solicitudes en poco tiempo.
500 / 502 / 503	Error interno o fuente oficial no disponible.

Solo se cobra 1 crédito cuando la consulta devuelve datos del vehículo. Referencia completa en errores.

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