Consultas de patente

Consultar un vehículo#

Usá la patente directamente en la URL: GET /v2/vehicles/:plate.

curl 'https://api.clasific.ar/v2/vehicles/ZZ000ZZ' \
  -H 'x-api-key: <TU_API_KEY>'

La API normaliza la patente y valida los formatos argentinos soportados antes de realizar la consulta. Se admiten patentes de autos en formato antiguo y Mercosur.

Cada consulta aceptada consume 1 consulta de patente. Los requests rechazados antes de ser aceptados no consumen cupo de consultas.

Respuesta#

La respuesta indica si hay información disponible para la patente:

• success indica que el request se procesó correctamente.
• found indica si encontramos información.
• data contiene los datos del vehículo.

Ejemplo abreviado con datos de prueba; la respuesta completa puede incluir más campos:

{
  "success": true,
  "found": true,
  "data": {
    "plate": "ZZ000ZZ",
    "make": "TOYOTA",
    "model": "COROLLA 1.8",
    "year": 2020
  }
}

Si no encontramos información disponible:

{
  "success": true,
  "found": false,
  "data": null
}

found: false significa que la consulta fue válida pero no encontramos información disponible para esa patente. Es una consulta procesada normalmente y consume 1 consulta de patente.

Opciones#

Podés agregar opciones mediante query parameters para enriquecer la respuesta. Por ejemplo: ?codia=true o ?sheet=true.

codia, sheet, tires y onMiss=search están disponibles en planes pagos y Custom.

debug=true puede agregar información de diagnóstico en data.debug. No cambia la consulta ni su consumo.

Buscar cuando no hay datos#

Si no encontramos información disponible, podés solicitar una búsqueda adicional con onMiss=search:

curl 'https://api.clasific.ar/v2/vehicles/ZZ000ZZ?onMiss=search' \
  -H 'x-api-key: <TU_API_KEY>'

Si ya hay información suficiente, recibís la respuesta normal. Si hace falta buscar más, la API responde HTTP 202 con una operación asincrónica:

{
  "id": "op_92cff723-014a-4b1a-aa26-82bb5287e6aa",
  "kind": "vehicle",
  "status": "queued",
  "plate": "ZZ000ZZ",
  "result": null,
  "createdAt": "2026-09-06T12:00:00.000Z",
  "updatedAt": "2026-09-06T12:00:00.000Z"
}

Usá el ID para consultar el resultado:

GET /v2/operations/:id

El polling no vuelve a consumir una consulta de patente. Cuando la operación termina, result contiene el resultado de la búsqueda.

• Consultar una operación →

Para ver todos los campos, parámetros y códigos de respuesta, consultá la referencia OpenAPI.

• Referencia OpenAPI →