Endpoint: reporte de hurto de un vehículo por placa

Responde, solo con la placa, si el vehículo quedó vinculado a una denuncia de hurto o a otro proceso penal: el papel del vehículo en cada caso (hurtado, decomisado a quien lo tenía robado, objeto de un abuso de confianza, incautado, involucrado en un accidente o usado para cometer un delito), la fecha, el número de noticia criminal, el delito y si el caso sigue activo o se archivó. Cada registro trae la marca, línea, modelo y color con que quedó el vehículo en el caso, para confirmar que es el mismo de la ficha. Un «sin registros» es una respuesta definitiva y cobra, pero no prueba que el vehículo nunca se haya robado: un robo que se recuperó sin denuncia no aparece, y una denuncia activa no significa que el vehículo siga desaparecido.

POST/api/reporte-hurto1 crédito

Denuncias de hurto y demás procesos penales en los que quedó vinculado un vehículo, solo con la placa. Cada registro dice el papel del vehículo en el caso (categoria: hurto, receptacion —vehículo robado decomisado a quien lo tenía—, abuso_de_confianza, incautacion, accidente, usado_en_delito, otro), el tipo de vinculación literal, la fecha, el número de noticia criminal, el delito, el estado del caso (ACTIVO o INACTIVO con su motivo de archivo) y los datos del vehículo tal como quedaron en el caso, para cotejarlos con la ficha (una placa mal digitada en una denuncia cae sobre otra placa). Resume con reportadoHurto y denunciaHurtoActiva, e incluye procesos de extinción de dominio. status es danger con una denuncia de hurto activa, warn con cualquier otro registro y ok sin registros. Una placa sin registros cobra: es una respuesta definitiva, aunque no prueba que el vehículo nunca se haya robado (un robo recuperado sin denuncia no aparece). Cuesta 1 crédito.

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. 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.
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/reporte-hurto' \
  -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/reporte-hurto", {
  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/reporte-hurto",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"placa":"ABC123"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)
{
  "source": "hurto",
  "status": "danger",
  "data": {
    "placa": "ABC123",
    "reportadoHurto": true,
    "denunciaHurtoActiva": true,
    "totalRegistros": 2,
    "registros": [
      {
        "categoria": "hurto",
        "tipoVinculacion": "HURTADO",
        "fechaVinculacion": "2026-09-21",
        "noticiaCriminal": "760016000193202612345",
        "vehiculo": {
          "marca": "YAMAHA",
          "linea": "FZN150D (FZ-S)",
          "modelo": "2025",
          "clase": "FAMILIAR",
          "servicio": "PRIVADO",
          "color": "AZUL"
        },
        "delitos": [
          "HURTO CALIFICADO DE AUTOMOTOR MENOR CUANTIA ART. 240 C.P."
        ],
        "estadoCaso": "ACTIVO",
        "motivoEstado": null,
        "etapa": "INDAGACIÓN",
        "fechaHechos": "2026-09-20",
        "seccional": "DIRECCIÓN SECCIONAL DE CALI",
        "reservado": false,
        "detalleDisponible": true
      },
      {
        "categoria": "accidente",
        "tipoVinculacion": "ELEMENTO CAUSANTE DEL DELITO",
        "fechaVinculacion": "2023-05-14",
        "noticiaCriminal": "760016000193202300987",
        "vehiculo": {
          "marca": "YAMAHA",
          "linea": "FZN150D (FZ-S)",
          "modelo": "2025",
          "clase": "FAMILIAR",
          "servicio": "PRIVADO",
          "color": "AZUL"
        },
        "delitos": [
          "LESIONES CULPOSAS ART. 120 C.P. MEDIO MOTORIZADO INCISO 2"
        ],
        "estadoCaso": "INACTIVO",
        "motivoEstado": "Archivo por conducta atipica art.79 c.p.",
        "etapa": "INDAGACIÓN",
        "fechaHechos": "2023-05-13",
        "seccional": "DIRECCIÓN SECCIONAL DE CALI",
        "reservado": false,
        "detalleDisponible": true
      }
    ],
    "extincionDominio": [],
    "bienesAdministrados": 0,
    "fuente": "Noticias criminales y procesos de extinción de dominio registrados por la autoridad judicial",
    "cobertura": "Denuncias y procesos penales en los que la placa quedó vinculada. Un vehículo robado y recuperado sin denuncia no aparece; una denuncia activa no significa que el vehículo siga desaparecido. Compara los datos del vehículo de cada registro con la ficha: una placa mal digitada en una denuncia puede caer sobre otra placa."
  },
  "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: 23 de septiembre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto