API impuesto vehicular Colombia: saldo pendiente por placa
PlacApi ofrece una API REST para consultar el impuesto vehicular de un vehículo colombiano. Con la placa y el documento devuelve en JSON si el impuesto está al día y el saldo pendiente según la secretaría de hacienda del departamento donde está matriculado.
Qué problema resuelve
Cada departamento tiene su propio portal de impuesto vehicular. Consolidar el saldo pendiente de vehículos de distintos departamentos en un solo flujo es inviable a mano; esta API normaliza esa consulta.
Para quién sirve
Compraventas, gestores de trámites, flotas multi-departamento y fintechs que evalúan cargas pendientes antes de un traspaso o un crédito.
Datos requeridos
- placa — placa del vehículo.
- docType y docNumber — documento del propietario.
Fuentes y cobertura
- Secretarías de hacienda departamentalSaldo del impuesto vehicular por año y departamento (Bogotá, Antioquia, Valle, etc.).
Ejemplo de solicitud
POST https://placapi.com/api/consulta. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.
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"}'Ejemplo de respuesta
Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).
{
"impuestos": {
"status": "ok",
"data": {
"departamento": "CUNDINAMARCA",
"alDia": false,
"saldoPendiente": 320000,
"detalle": [
{
"anio": 2025,
"valor": 320000,
"estado": "pendiente"
}
]
}
}
}Explicación campo por campo
| Campo | Tipo | Descripción |
|---|---|---|
| impuestos.data.departamento | string | Departamento de matrícula que gestiona el impuesto. |
| impuestos.data.alDia | boolean | true si no hay saldo pendiente. |
| impuestos.data.saldoPendiente | number (COP) | Total pendiente por pagar. |
| impuestos.data.detalle[] | array | Saldo por año con su estado. |
Tiempo de respuesta
Entre 30 y 90 segundos la primera vez —es lo que tardan los portales oficiales en responder—. Reconsultar la misma placa es casi instantáneo porque el resultado queda en caché.
Precio y cobro
1 crédito por consulta con datos = 499 COP. Los créditos se compran por adelantado (mínimo 10 = 4.990 COP), no vencen y no hay mensualidad. El mismo precio aplica por API. Solo se cobra cuando la consulta devuelve datos.
Caché y actualización
El saldo del impuesto se cachea por horas/días según el departamento; conviene refrescar antes de un trámite.
Seguridad y privacidad
La placa y el documento se usan solo para ejecutar la consulta; el resultado queda en caché temporal. No se almacenan datos de tarjetas (los pagos los procesa Wompi). Ver privacidad y seguridad.
Limitaciones y posibles errores
- La cobertura depende de que la secretaría del departamento tenga consulta en línea disponible.
- Un pago reciente puede tardar en reflejarse en el portal departamental.
- PlacApi no recauda impuestos; reporta el saldo que publica cada secretaría.
Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.
Preguntas frecuentes
¿Cubre todos los departamentos?
+
Cubrimos los principales; si un departamento no tiene consulta en línea, esa fuente devuelve estado vacío o error, sin inventar datos.
¿Incluye intereses de mora?
+
El saldo refleja lo que reporta la secretaría, que suele incluir intereses; verifica el detalle por año.
Seguir explorando
Última revisión: 11 de julio de 2026 · Versión de la API: v1 · Fuentes y metodología