API pico y placa Colombia: si aplica hoy según la placa y la ciudad
PlacApi ofrece una API REST para saber si un vehículo tiene pico y placa hoy en las principales ciudades de Colombia. Con la placa (y opcionalmente la ciudad) devuelve en JSON si la restricción aplica y las reglas vigentes para Bogotá, Medellín, Cali, Barranquilla, Cartagena y Bucaramanga.
Qué problema resuelve
El pico y placa es rotativo y cambia por cuatrimestre y por ciudad. Mantener esas reglas dentro de una app de movilidad o logística es un trabajo continuo; PlacApi las mantiene actualizadas y las expone por API.
Para quién sirve
Apps de movilidad, logística y última milla que planifican rutas, y productos que avisan al usuario si puede circular hoy.
Datos requeridos
- placa — placa del vehículo.
- ciudad — opcional; si se omite se evalúan las ciudades cubiertas.
Fuentes y cobertura
- Secretarías de movilidadReglas de pico y placa vigentes por ciudad, actualizadas por cuatrimestre.
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).
{
"picoYPlaca": {
"status": "ok",
"data": {
"hoyAplica": false,
"ciudad": "BOGOTA",
"detalle": {
"digitosHoy": [
1,
2
],
"horario": "6:00-21:00",
"aplicaManana": true
}
}
}
}Explicación campo por campo
| Campo | Tipo | Descripción |
|---|---|---|
| picoYPlaca.data.hoyAplica | boolean | true si el vehículo tiene restricción hoy. |
| picoYPlaca.data.ciudad | string | Ciudad evaluada. |
| picoYPlaca.data.detalle.digitosHoy | number[] | Últimos dígitos de placa restringidos hoy. |
| picoYPlaca.data.detalle.horario | string | Franja horaria de la restricción. |
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
Las reglas se actualizan por cuatrimestre; la evaluación de "hoy" se calcula en el momento sobre las reglas vigentes.
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
- Cubrimos las seis ciudades principales; otras ciudades pueden no estar disponibles.
- Ante medidas extraordinarias (día sin carro, contingencias ambientales) valida también con la secretaría local.
- PlacApi no es una secretaría de movilidad; consolida las reglas vigentes.
Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.
Preguntas frecuentes
¿Qué ciudades cubre?
+
Bogotá, Medellín, Cali, Barranquilla, Cartagena y Bucaramanga. Se van sumando más según demanda.
¿Puedo saber si aplica mañana?
+
Sí, la respuesta incluye si la restricción aplica el día siguiente para planear con anticipación.
Seguir explorando
Última revisión: 11 de julio de 2026 · Versión de la API: v1 · Fuentes y metodología