Consultar un vehículo
Obtené datos históricos a partir de una patente argentina.
API v1Anterior/v1/vehicles/basicRetorna datos del vehículo desde la base histórica sin datos personales. La consulta estándar está disponible en Free; las búsquedas ante misses y los enriquecimientos CODIA y neumáticos requieren un plan pago o Custom.
- Autenticación
x-api-key- Consumo
- una consulta Basic mensual compartida entre V1 y V2
- Planes
- free · starter · growth · scale · custom
Request
Ejecutá este ejemplo desde tu servidor o terminal. Usá tu key en la variable CLASIFICAR_API_KEY.
curl -G "https://api.clasific.ar/v1/vehicles/basic" \
-H "x-api-key: $CLASIFICAR_API_KEY" \
--data-urlencode "plate=ABC123" \
--data-urlencode "classification=true"const apiKey = process.env.CLASIFICAR_API_KEY;
if (!apiKey) throw new Error("Falta CLASIFICAR_API_KEY");
const response = await fetch(
"https://api.clasific.ar/v1/vehicles/basic?plate=ABC123&classification=true",
{
headers: {
"x-api-key": apiKey,
},
},
);
if (!response.ok) {
throw new Error(
`HTTP ${response.status}: ${await response.text()}`,
);
}
const result: unknown = await response.json();
console.log(result);Parámetros
| Parámetro | Tipo / ubicación | Descripción |
|---|---|---|
plateRequerido | stringquery | Patente argentina (ABC123 o AB123CD) |
classificationOpcional | stringquery | Usá true para incluir clasificación inferida y cacheada del vehículo |
onMissOpcionalPago / Custom | stringquery | Usá search para encolar una búsqueda nueva cuando la patente no está en la base histórica; responde 202 mientras se procesa |
codiaOpcionalPago / Custom | stringquery | Usá true para incluir candidatos del catálogo CODIA activo |
tiresOpcionalPago / Custom | stringquery | Usá true para incluir medidas de neumáticos compatibles de los catálogos activos |
Variantes de consulta
Buscar cuando no existe en la base histórica
Si no hay datos locales, devuelve 202 con status.state=searching.
https://api.clasific.ar/v1/vehicles/basic?plate=ABC123&onMiss=searchAgregar CODIA y medidas de neumáticos
https://api.clasific.ar/v1/vehicles/basic?plate=ABC123&codia=true&tires=trueRespuesta
200 Ejemplo de respuesta. Los valores corresponden a datos ilustrativos del contrato V1.
{
"success": true,
"data": {
"plate": "ABC123",
"make": "TOYOTA",
"model": "COROLLA 1.8 SE-G CVT",
"year": 2019,
"firstRegistered": "2019-03-15",
"totalOwners": 3,
"currentOwners": 1,
"currentLocation": {
"city": "CAPITAL FEDERAL",
"province": "Ciudad Autónoma de Buenos Aires"
},
"locations": [
"CAPITAL FEDERAL, Ciudad Autónoma de Buenos Aires",
"LA PLATA, Buenos Aires"
],
"sourceDate": "2024-08-01",
"classification": {
"vehicleType": "AUTOMOTOR",
"bodyType": "SEDAN",
"vehicleCategory": "auto",
"confidence": "medium",
"source": "afip_model_match",
"matchedModel": "COROLLA SE-G 1.8 CVT 4 PUERTAS",
"matchedYear": 2019,
"approximateMatch": true,
"description": null,
"cacheHit": false
}
}
}200 Patente sin datos
Un HTTP 200 también puede indicar que la patente no se encontró. Comprobá el contenido de la respuesta.
{
"found": false
}202 Accepted — búsqueda en proceso
{
"success": true,
"data": null,
"status": {
"state": "searching",
"plate": "ABC123"
}
}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.
403 Forbidden — requiere plan pago
{
"error_code": "PAID_PLAN_REQUIRED",
"message": "onMiss=search, codia=true, and tires=true require a paid or Custom plan."
}