Pico y Placa API

GET /pico-placa/check

El endpoint principal — evalua si un vehiculo esta restringido.

Requiere API key. Consume cuota y rate limit del plan — ver Rate limits.

Parametros

ParametroRequeridoAplica aDescripcion
citySiTodosSlug de la ciudad (ver /pico-placa/cities)
dateNo (default: hoy)TodosFecha YYYY-MM-DD a evaluar
plateSiplate_digit_dayPlaca del vehiculo
labelSiemission_label_zoneEtiqueta ambiental (b, c, eco, 0, sin etiqueta)

Request

curl "https://api.placia.net/v1/pico-placa/check?city=bogota&plate=ABC123&date=2026-07-28" \
  -H "X-Api-Key: pyp_tu_key_aqui"

Response 200

{
  "success": true,
  "data": {
    "city": { "slug": "bogota", "name": "Bogota", "country": "Colombia", "timezone": "America/Bogota" },
    "date": "2026-07-28",
    "restriction_model": "plate_digit_day",
    "restricted": true,
    "reason": "Placa terminada en 3 restringida los tuesday",
    "details": { "day": "tuesday", "last_digit": 3, "hours": { "start": "06:00", "end": "21:00" } },
    "source_url": "https://www.bogota.gov.co/pico-y-placa",
    "last_verified": "2026-07-25 22:54:19",
    "disclaimer": "Informacion referencial verificada semanalmente por IA, no reemplaza la fuente oficial."
  }
}

Errores especificos

  • 401 — API key ausente, invalida o revocada.
  • 402 QUOTA_EXCEEDED — cuota mensual agotada.
  • 404 — ciudad no encontrada o sin regla vigente.
  • 422 — city o date invalidos.
  • 429 — limite de rafaga excedido.

On this page