Endpoint: consulta full (todo en uno)

El endpoint estrella: con la placa y la cédula del propietario devuelve, en una sola llamada, el bundle vehicular completo (datos del RUNT, SOAT, tecnomecánica, antecedentes, multas SIMIT, impuesto, avalúo FASECOLDA y pico y placa) MÁS la licencia de conducción del propietario. Si envías ciudad, o lat y lng (geolocaliza la ciudad y manda sobre ciudad), el pico y placa llega filtrado a esa ciudad con el detalle en picoYPlaca.ubicacion; sin ubicación trae todas las ciudades monitoreadas. El tipo de vehículo para el pico y placa se detecta solo desde la clase del RUNT (moto evalúa el primer dígito de la placa; carro el último). Cuesta 2 créditos y solo se cobra cuando hay datos del vehículo; la licencia es best-effort (con documento NIT se devuelve como null).

POST/api/consulta-full2 créditos

Todo el conjunto de fuentes en UNA sola llamada: bundle vehicular completo (RUNT, SOAT, tecnomecánica, antecedentes, multas SIMIT, impuesto, avalúo FASECOLDA y pico y placa) MÁS la licencia de conducción del propietario (por la misma cédula). Con `ciudad` o `lat`/`lng` (geolocaliza la ciudad; manda sobre `ciudad`) el pico y placa se filtra a esa ciudad y agrega `picoYPlaca.ubicacion`; sin ubicación trae todas las ciudades monitoreadas. El tipo de vehículo se detecta solo desde la clase RUNT (moto evalúa el primer dígito de la placa; carro el último). Cuesta 2 créditos.

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",
  "ciudad": "Bogotá"
}

Ejemplos por lenguaje

cURL

curl -X POST 'https://placapi.com/api/consulta-full' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"placa":"ABC123","docType":"CC","docNumber":"1020304050","ciudad":"Bogotá"}'

JavaScript (fetch)

const res = await fetch("https://placapi.com/api/consulta-full", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"placa":"ABC123","docType":"CC","docNumber":"1020304050","ciudad":"Bogotá"}),
});
const data = await res.json();

Python (requests)

import requests

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

Respuesta exitosa

200 OK — datos ficticios de ejemplo

{
  "input": {
    "placa": "ABC123",
    "docType": "CC",
    "docNumber": "1020304050"
  },
  "mode": "live",
  "generatedAt": "2026-07-24T15:04:05.000Z",
  "vehicle": {
    "source": "RUNT",
    "status": "ok",
    "fetchedAt": "2026-07-24T15:04:05.000Z",
    "mode": "live",
    "data": {
      "placa": "ABC123",
      "marca": "MAZDA",
      "linea": "CX-30",
      "modelo": 2023,
      "cilindraje": 2000,
      "combustible": "GASOLINA",
      "servicio": "Particular",
      "carroceria": "CAMIONETA",
      "color": "ROJO",
      "motor": "MTR0000001",
      "chasis": "9GAJC6915FB040270",
      "vin": "9GAJC6915FB040270",
      "fechaMatricula": "15/03/2023",
      "organismoTransito": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA",
      "estado": "activo",
      "clase": "CAMIONETA"
    }
  },
  "soat": {
    "source": "RUNT",
    "status": "ok",
    "fetchedAt": "2026-07-24T15:04:05.000Z",
    "mode": "live",
    "data": {
      "vigente": true,
      "aseguradora": "SBS SEGUROS",
      "poliza": "1508006948335000",
      "fechaExpedicion": "20/09/2025",
      "fechaVencimiento": "19/09/2026",
      "diasParaVencer": 69
    }
  },
  "rtm": {
    "source": "RUNT",
    "status": "ok",
    "fetchedAt": "2026-07-24T15:04:05.000Z",
    "mode": "live",
    "data": {
      "vigente": true,
      "exento": false,
      "fechaPrimeraRevision": null,
      "cda": "CDA FONTIBON S.A.S",
      "fechaExpedicion": "22/09/2025",
      "fechaVencimiento": "22/09/2026",
      "diasParaVencer": 72,
      "certificadoNumero": "189733821"
    }
  },
  "antecedentes": {
    "source": "RUNT",
    "status": "ok",
    "fetchedAt": "2026-07-24T15:04:05.000Z",
    "mode": "live",
    "data": {
      "prendas": [
        {
          "acreedor": "RCI COLOMBIA S.A. COMPAÑIA DE FINANCIAMIENTO",
          "docAcreedor": "900977629",
          "tipoDocAcreedor": "NIT",
          "fechaInscripcion": "2021-09-30",
          "confecamaras": true
        }
      ],
      "embargos": [],
      "historicoPropietarios": 1
    }
  },
  "simit": {
    "source": "SIMIT",
    "status": "ok",
    "fetchedAt": "2026-07-24T15:04:05.000Z",
    "mode": "live",
    "data": {
      "totalDeuda": 0,
      "totalMultas": 0,
      "multas": [],
      "acuerdosPago": 0
    }
  },
  "impuestos": {
    "source": "Bogotá D.C.",
    "status": "info",
    "fetchedAt": "2026-07-24T15:04:05.000Z",
    "mode": "live",
    "data": null,
    "portalUrl": "https://www.haciendabogota.gov.co/es/sdh/pagos-impuesto-vehiculos",
    "error": "Tu vehículo está matriculado en Bogotá D.C. Paga tu impuesto en el portal oficial del departamento."
  },
  "fasecolda": {
    "source": "FASECOLDA",
    "status": "info",
    "fetchedAt": "2026-07-24T15:04:05.000Z",
    "mode": "live",
    "data": {
      "codigo": "08053096",
      "marca": "MAZDA",
      "linea": "CX-30",
      "modelo": 2023,
      "valorComercial": 98000000,
      "rangoMercado": {
        "min": 92000000,
        "max": 104000000
      },
      "clase": "CAMIONETA"
    }
  },
  "picoYPlaca": {
    "source": "pico-y-placa",
    "status": "ok",
    "fetchedAt": "2026-07-24T15:04:05.000Z",
    "mode": "live",
    "ubicacion": {
      "matched": true,
      "source": "ciudad",
      "consulta": {
        "ciudad": "Bogotá"
      },
      "ciudad": "Bogotá",
      "departamento": "Bogotá D.C."
    },
    "data": [
      {
        "ciudad": "Bogotá",
        "departamento": "Bogotá D.C.",
        "tipoVehiculo": "carro",
        "tienePicoYPlaca": true,
        "esquema": "parImpar",
        "hoyAplica": false,
        "manianaAplica": true,
        "digitosHoy": [
          1,
          2,
          3,
          4,
          5
        ],
        "digitosManiana": [
          6,
          7,
          8,
          9,
          0
        ],
        "diasSemana": [],
        "horarios": "L–V, 6:00–21:00",
        "vigencia": "Vigente en julio de 2026",
        "fuente": "https://www.movilidadbogota.gov.co/pico-y-placa"
      }
    ]
  },
  "licencia": {
    "data": {
      "documentType": "CC",
      "documentNumber": "1020304050",
      "fullName": "JUAN PÉREZ",
      "driverStatus": "ACTIVO",
      "citizenStatus": "ACTIVA",
      "totalLicenses": "1",
      "licenses": [
        {
          "category": "B1",
          "status": "ACTIVA",
          "licenceNumber": "1020304050",
          "otExpide": "INSTITUTO DE MOVILIDAD",
          "expeditionDate": "23/04/2025",
          "dueDate": "23/04/2035",
          "restrictions": null
        }
      ],
      "infractions": {
        "tieneMultas": "NO",
        "nroPazYSalvo": "885466652067"
      }
    },
    "mode": "live",
    "fetchedAt": "2026-07-24T15:04:05.000Z"
  },
  "cost": 2
}

Códigos de error

Código	Significado
400	Cuerpo inválido: placa o documento con formato incorrecto (code: bad_request).
401	No autenticado o API key inválida (code: unauthorized).
402	Sin créditos suficientes para la consulta (code: no_credits).
404	La fuente respondió y no hay datos. No reintentar: el resultado sería el mismo. No se cobra crédito.
429	Rate limit: 1000 consultas/minuto por API key. Respeta el header Retry-After.
500	Error interno (code: internal_error).
502	La fuente oficial no respondió a tiempo (code: source_error). Reintentar sirve. No se cobra crédito.

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

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