Endpoint: pérdida total y siniestros por placa

Devuelve el historial de reclamaciones de un vehículo ante las aseguradoras, desde 2008, solo con la placa: fecha, amparo y severidad de cada registro. Una severidad mayor significa que la aseguradora indemnizó el vehículo completo, es decir pérdida total; una menor, que indemnizó una reparación. La bandera perdidaTotal es verdadera solo si hay al menos un registro de severidad mayor, así que un carro con reclamaciones menores devuelve falso con siniestros mayores que cero. La cobertura es parcial por naturaleza: solo alcanza a vehículos que estuvieron asegurados.

POST/api/perdida-total2 créditos

Historial de reclamaciones ante aseguradoras de un vehículo (fuente FASECOLDA, desde 2008): fecha, amparo y `severidad` de cada registro. Solo pide la placa. `severidad: "mayor"` = la aseguradora indemnizó el vehículo completo (pérdida total); `"menor"` = indemnizó una reparación; `"desconocida"` = amparo que la fuente no cataloga. `perdidaTotal` es true SOLO si hay al menos un registro de severidad mayor, así que un carro con reclamaciones menores devuelve `perdidaTotal: false` con `totalSiniestros > 0`. Cobertura parcial: cubre únicamente vehículos que estuvieron asegurados, así que `perdidaTotal: false` significa «no figura», no «nunca chocó». La fuente no informa el valor indemnizado ni la aseguradora. `status` es danger con pérdida total, warn con reclamaciones menores y ok sin registros. Cuesta 2 créditos (el scrape es lento y la fuente topa las consultas diarias).

Cuerpo de la solicitud

body (JSON)
{
  "placa": "ABC123"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
placaobligatoriostringPlaca 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.
refreshbooleanIgnora 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
curl -X POST 'https://placapi.com/api/perdida-total' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"placa":"ABC123"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/perdida-total", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"placa":"ABC123"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/perdida-total",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"placa":"ABC123"},
)
data = res.json()

Respuesta exitosa

200 OK — datos ficticios de ejemplo
{
  "source": "siniestros",
  "status": "danger",
  "data": {
    "placa": "ABC123",
    "perdidaTotal": true,
    "totalSiniestros": 2,
    "siniestros": [
      {
        "fecha": "2022-09-13",
        "amparo": "Pérdida Mayor Cuantía",
        "severidad": "mayor"
      },
      {
        "fecha": "2015-01-20",
        "amparo": "Pérdida Menor Cuantía",
        "severidad": "menor"
      }
    ],
    "fuente": "Reclamaciones reportadas por aseguradoras",
    "cobertura": "Solo vehículos que estuvieron asegurados; reclamaciones reportadas por las aseguradoras desde 2008."
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z"
}

Errores y cobro

Cuesta 2 créditos 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: 23 de agosto de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto