Endpoint: accidentes de tránsito en Bogotá por placa
Devuelve los accidentes de tránsito que registró la autoridad de movilidad de Bogotá para un vehículo, solo con la placa: fecha, gravedad, número de formulario y código del informe IPAT, con los más recientes primero y una gravedad máxima de resumen. Es el complemento natural de /api/perdida-total: ese historial solo ve reclamaciones de vehículos asegurados y de mayor cuantía, mientras este registro incluye los choques sin heridos y no exige que el vehículo tenga póliza. La cobertura es solo Bogotá, y una placa sin registros responde una lista vacía —que es una respuesta definitiva y cobra—, no un error.
Accidentes de tránsito registrados por la autoridad de movilidad de Bogotá (informes IPAT) de un vehículo, por placa: fecha, gravedad (SOLO DAÑOS, CON HERIDOS, CON MUERTOS), número de formulario y código del informe, más recientes primero, con gravedadMaxima como resumen. Complementa a /api/perdida-total: esa fuente solo ve reclamaciones de vehículos asegurados y de mayor cuantía, mientras este registro incluye los choques sin heridos y no exige que el vehículo esté asegurado — a cambio cubre únicamente Bogotá. Una placa sin registros devuelve totalAccidentes: 0 y cobra: «no registra accidentes» es una respuesta definitiva. status es danger con heridos o muertos, warn con solo daños y ok sin registros. Cuesta 1 crédito.
Cuerpo de la solicitud
{
"placa": "ABC123"
}| Campo | Tipo | Qué es |
|---|---|---|
| placaobligatorio | string | Placa del vehículo. 5 a 7 caracteres alfanuméricos: cubre AAA000, AAA00A y los formatos menos comunes (AAA00, AAAA00). Los guiones y espacios se ignoran. Si la mandas dentro del alias interno de tu flota (`ABC12D_JPG`, `ABC12D-JUAN-PEREZ`, `ABC12D-MOVIL-11`) se extrae la placa, siempre que en el texto haya UNA sola: con dos o con ninguna la respuesta es 400. |
| refresh | boolean | Ignora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no). |
Ejemplos por lenguaje
curl -X POST 'https://placapi.com/api/accidentes-bogota' \
-H 'x-api-key: pk_live_TU_CLAVE' \
-H 'content-type: application/json' \
-d '{"placa":"ABC123"}'const res = await fetch("https://placapi.com/api/accidentes-bogota", {
method: "POST",
headers: {
"x-api-key": "pk_live_TU_CLAVE",
"content-type": "application/json",
},
body: JSON.stringify({"placa":"ABC123"}),
});
const data = await res.json();import requests
res = requests.post(
"https://placapi.com/api/accidentes-bogota",
headers={"x-api-key": "pk_live_TU_CLAVE"},
json={"placa":"ABC123"},
)
data = res.json()Respuesta exitosa
{
"source": "accidentes",
"status": "danger",
"data": {
"placa": "ABC123",
"totalAccidentes": 2,
"gravedadMaxima": "con_heridos",
"accidentes": [
{
"fecha": "2019-03-15",
"fechaTexto": "VIERNES, 15 MARZO 2019 06:00 AM",
"gravedad": "CON HERIDOS",
"formulario": "11036135",
"ipat": "A000966585"
},
{
"fecha": "2012-09-13",
"fechaTexto": "JUEVES, 13 SEPTIEMBRE 2012 08:20 AM",
"gravedad": "SOLO DAÑOS",
"formulario": "998877",
"ipat": "A000000000"
}
],
"fuente": "Accidentes de tránsito reportados por la autoridad de tránsito de Bogotá",
"cobertura": "Solo accidentes ocurridos en Bogotá; no cubre otras ciudades. Incluye choques sin heridos (solo daños)."
},
"mode": "live",
"fetchedAt": "2026-07-24T15:04:05.000Z"
}Errores y cobro
Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.
Última revisión: 13 de septiembre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.