Reportes
Crear un reporte
Iniciá un reporte asincrónico para una patente.
API v1AnteriorPOST
/v1/reportsCrea un reporte inteligente asincrónico y devuelve directamente el DTO público del job. El ID opaco usa prefijo rep_; si existe cache lista puede devolver el reporte final en la misma respuesta. Soporta Idempotency-Key para retries sin doble consumo. El resultado se envía al webhook activo configurado para el owner y el entorno.
- Autenticación
x-api-key- Consumo
- intelligent + cuota mensual; replay sin doble consumo
- Planes
- starter · growth · scale · custom
Request
Ejecutá este ejemplo desde tu servidor o terminal. Usá tu key en la variable CLASIFICAR_API_KEY.
Terminal
curl -X POST "https://api.clasific.ar/v1/reports" \
-H "x-api-key: $CLASIFICAR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: mi-consulta-001" \
-d '{"plate":"ABC123"}'TypeScript · servidor
const apiKey = process.env.CLASIFICAR_API_KEY;
if (!apiKey) throw new Error("Falta CLASIFICAR_API_KEY");
// Conservá esta key al reintentar la misma operación.
const idempotencyKey = crypto.randomUUID();
const response = await fetch(
"https://api.clasific.ar/v1/reports",
{
method: "POST",
headers: {
"x-api-key": apiKey,
"Content-Type": "application/json",
"Idempotency-Key": idempotencyKey,
},
body: JSON.stringify({
"plate": "ABC123"
}),
},
);
if (!response.ok) {
throw new Error(
`HTTP ${response.status}: ${await response.text()}`,
);
}
const result: unknown = await response.json();
console.log(result);Usá una key de idempotencia nueva por operación lógica y conservála en sus reintentos. El valor del ejemplo curl debe reemplazarse para una consulta nueva.
Parámetros
Headers adicionales
| Parámetro | Tipo / ubicación | Descripción |
|---|---|---|
Idempotency-KeyOpcional | stringheader | Opcional y recomendado para retries sin crear otro reporte ni consumir cuota dos veces |
Body JSON
| Parámetro | Tipo / ubicación | Descripción |
|---|---|---|
plateRequerido | stringbody | Patente argentina (ABC123 o AB123CD) |
Respuesta
202 Ejemplo de respuesta. Los valores corresponden a datos ilustrativos del contrato V1.
Response · JSON
{
"id": "rep_8d2c7ef49d8b4c8fa27d1d8906229341",
"status": "processing",
"plate": "ABC123",
"report": null,
"createdAt": "2026-05-15T12:00:00.000Z",
"updatedAt": "2026-05-15T12:00:03.000Z",
"completedAt": null
}200 OK — reporte completado disponible
JSON
{
"id": "rep_8d2c7ef49d8b4c8fa27d1d8906229341",
"status": "completed",
"plate": "JFK106",
"report": {
"vehicle": {
"plate": "JFK106",
"make": "LAND ROVER",
"model": "RANGE ROVER 3.6 HSE TDV8",
"year": 2010,
"vehicleType": "AUTOMOTOR",
"firstRegistered": "2010-09-07",
"totalOwners": 2,
"currentOwners": 1,
"registryOffice": "02044 - CAPITAL FEDERAL N 044",
"currentLocation": {
"city": "CABA",
"province": "CAPITAL FEDERAL"
},
"locations": [
"C.AUTONOMA DE BS.AS, Ciudad Autonoma de Buenos Aires",
"CABA, CAPITAL FEDERAL"
],
"sourceDate": "2026-05-15",
"queryDate": "2026-05-15",
"quote": null
},
"possibleOwners": [
{
"name": "V******, S*",
"id": {
"type": "CUIT",
"value": "30*"
}
}
],
"results": {
"fines": {
"total": 1,
"amountTotal": 427495.5,
"currency": "ARS",
"items": [
{
"date": "2023-09-24T08:48:00-03:00",
"amount": 427495.5,
"status": "voluntary_payment",
"authority": null,
"reference": "Q29775884",
"description": "Exceso de velocidad de 10% a 30% más de la velocidad permitida",
"jurisdiction": "CABA",
"dueDate": null,
"discountedAmount": null
}
]
},
"vtv": {
"total": 1,
"items": [
{
"type": "vtv",
"date": "2024-08-26",
"sticker": "4581967",
"inspectionType": "inspection",
"detail": "Particulares",
"result": "approved",
"certificate": "6227143",
"jurisdiction": "CABA",
"facility": "9 de Julio Sur",
"dueDate": "2025-06-01"
}
]
},
"tax_debt": {
"total": 1,
"amountTotal": 235757.86,
"currency": "ARS",
"items": [
{
"period": "2026/3",
"description": "POSICION",
"dueDate": "2026-06-22",
"amount": 235757.86,
"updatedAmount": 235757.86,
"status": "expired",
"jurisdiction": "CABA"
}
]
},
"cng": {
"total": 1,
"items": [
{
"operationDate": "2024-03-12",
"workshop": "Taller GNC Ejemplo",
"workshopTaxId": "30-00000000-0",
"workshopCode": "GNC-123",
"wafer": "12345678",
"previousWafer": "87654321"
}
]
}
},
"digest": {
"summary": "El historial registra infracciones y deuda de patente en CABA.",
"headline": "Multas y deuda de patente detectadas",
"riskLevel": "high",
"highlights": [
"1 infracción en CABA por al menos $427.496.",
"Deuda de patente en CABA por aproximadamente $235.758."
],
"issues": [
{
"title": "Infracciones en CABA",
"severity": "high",
"detail": "Registra 1 infracción por al menos $427.496 en pago voluntario."
}
],
"positives": [],
"noRecords": [],
"ownershipEstimate": {
"estimatedHistoricalOwnerCount": 2,
"confidence": "medium",
"basis": "El resumen registral consolidado muestra 2 titulares históricos."
},
"recommendation": "Pedí el detalle actualizado de multas y deuda antes de avanzar."
}
},
"createdAt": "2026-05-15T12:00:00.000Z",
"updatedAt": "2026-05-15T12:03:00.000Z",
"completedAt": "2026-05-15T12:03:00.000Z"
}Errores
Comprobá el estado HTTP antes de procesar el resultado. Los formatos de error pueden variar por endpoint. Consultá errores y rate limits para gestionar errores de acceso y capacidad.