Catálogo de vehículos

Acceso y consumo

Consultá marcas, modelos, versiones con su código CODIA y años disponibles, sin necesidad de una patente.

Disponible para cuentas activas con plan Basic, Growth, Scale o Custom. Las consultas no consumen cupos ni generan cargos adicionales; sólo cuentan para el límite de requests por minuto de la cuenta. Podés usarlas aunque hayas agotado tus cupos de consultas.

Autenticá cada request con el header x-api-key. El plan Free no tiene acceso al catálogo, tampoco en Sandbox.

Consultar marcas

Devuelve las marcas disponibles, ordenadas por nombre. No requiere parámetros.

Terminal

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

Respuesta HTTP 200 abreviada; se muestran tres marcas de la lista:

JSON

{
  "data": [
    {
      "id": "51",
      "name": "FERRARI"
    },
    {
      "id": "17",
      "name": "FIAT"
    },
    {
      "id": "18",
      "name": "FORD"
    }
  ],
  "meta": {
    "catalogVersion": "cat_9fbed2e872381f2fd54e92f9"
  }
}

Usá el id de la marca como brandId para consultar sus modelos.

Consultar modelos

Devuelve los modelos de una marca, ordenados por nombre. El parámetro brandId es obligatorio. Por ejemplo, para Fiat:

Terminal

curl 'https://api.clasific.ar/v2/catalog/models?brandId=17' \
  -H 'x-api-key: <TU_API_KEY>'

Respuesta HTTP 200 abreviada; se muestran tres modelos de Fiat:

JSON

{
  "data": [
    {
      "id": "mdl_17_30",
      "name": "BRAVO"
    },
    {
      "id": "mdl_17_52",
      "name": "CRONOS"
    },
    {
      "id": "mdl_17_42",
      "name": "DOBLO"
    }
  ],
  "meta": {
    "catalogVersion": "cat_9fbed2e872381f2fd54e92f9"
  }
}

Usá el id del modelo como único parámetro modelId para consultar las versiones.

Consultar versiones

Devuelve las versiones de un modelo, ordenadas por nombre. Cada versión incluye los campos id, name y codia (su código CODIA). El único parámetro obligatorio es modelId. Por ejemplo, para Fiat Cronos:

Terminal

curl 'https://api.clasific.ar/v2/catalog/versions?modelId=mdl_17_52' \
  -H 'x-api-key: <TU_API_KEY>'

Respuesta HTTP 200:

JSON

{
  "data": [
    {
      "id": "ia_170846",
      "name": "1.3 ATTRACTIVE",
      "codia": "170846"
    },
    {
      "id": "ia_170858",
      "name": "1.3 ATTRACTIVE L/22",
      "codia": "170858"
    },
    {
      "id": "ia_170801",
      "name": "1.3 DRIVE FIREFLY",
      "codia": "170801"
    },
    {
      "id": "ia_170810",
      "name": "1.3 DRIVE GSE",
      "codia": "170810"
    },
    {
      "id": "ia_170823",
      "name": "1.3 DRIVE GSE PACK CONECTI.",
      "codia": "170823"
    },
    {
      "id": "ia_170835",
      "name": "1.3 DRIVE GSE PACK CONECTIVIDAD L/21",
      "codia": "170835"
    },
    {
      "id": "ia_170843",
      "name": "1.3 DRIVE GSE S-DESIGN",
      "codia": "170843"
    },
    {
      "id": "ia_170859",
      "name": "1.3 DRIVE L/22",
      "codia": "170859"
    },
    {
      "id": "ia_170860",
      "name": "1.3 DRIVE L/22 CVT",
      "codia": "170860"
    },
    {
      "id": "ia_170861",
      "name": "1.3 DRIVE L/22 S-DESIGN",
      "codia": "170861"
    },
    {
      "id": "ia_170890",
      "name": "1.3 DRIVE L/25 PACK PLUS",
      "codia": "170890"
    },
    {
      "id": "ia_170891",
      "name": "1.3 DRIVE L/25 PACK PLUS CVT",
      "codia": "170891"
    },
    {
      "id": "ia_170866",
      "name": "1.3 GSE DRIVE PACK PLUS L/23",
      "codia": "170866"
    },
    {
      "id": "ia_170879",
      "name": "1.3 GSE DRIVE PACK PLUS L/23 CVT",
      "codia": "170879"
    },
    {
      "id": "ia_170865",
      "name": "1.3 GSE LIKE L/23",
      "codia": "170865"
    },
    {
      "id": "ia_170867",
      "name": "1.3 GSE STILE L/23",
      "codia": "170867"
    },
    {
      "id": "ia_170889",
      "name": "1.3 LIKE L/25",
      "codia": "170889"
    },
    {
      "id": "ia_170892",
      "name": "1.3 PRECISION CVT L/25",
      "codia": "170892"
    },
    {
      "id": "ia_170862",
      "name": "1.3 PRECISION L/22",
      "codia": "170862"
    },
    {
      "id": "ia_170826",
      "name": "1.8 CENTENARIO AUT E/LIM",
      "codia": "170826"
    },
    {
      "id": "ia_170855",
      "name": "1.8 HGT",
      "codia": "170855"
    },
    {
      "id": "ia_170803",
      "name": "1.8 PRECISION",
      "codia": "170803"
    },
    {
      "id": "ia_170802",
      "name": "1.8 PRECISION AUT",
      "codia": "170802"
    },
    {
      "id": "ia_170837",
      "name": "1.8 PRECISION AUT L/21",
      "codia": "170837"
    },
    {
      "id": "ia_170836",
      "name": "1.8 PRECISION L/21",
      "codia": "170836"
    },
    {
      "id": "ia_170870",
      "name": "1.8 PRECISION L/21 PACK PREMIUM A",
      "codia": "170870"
    },
    {
      "id": "ia_170825",
      "name": "1.8 PRECISION PACK PREMIUM",
      "codia": "170825"
    },
    {
      "id": "ia_170844",
      "name": "1.8 PRECISION PACK PREMIUM L/21",
      "codia": "170844"
    },
    {
      "id": "ia_170845",
      "name": "1.8 PRECISION PACK STYLE L/21",
      "codia": "170845"
    },
    {
      "id": "ia_170824",
      "name": "1.8 PRECISION TECHNOLOGY",
      "codia": "170824"
    },
    {
      "id": "ia_170914",
      "name": "L/26 1.3 CVT",
      "codia": "170914"
    },
    {
      "id": "ia_170913",
      "name": "L/26 1.3 DRIVE PLUS",
      "codia": "170913"
    },
    {
      "id": "ia_170912",
      "name": "L/26 1.3 LIKE",
      "codia": "170912"
    },
    {
      "id": "ia_170915",
      "name": "L/26 1.3 PRECISION CVT",
      "codia": "170915"
    }
  ],
  "meta": {
    "catalogVersion": "cat_9fbed2e872381f2fd54e92f9"
  }
}

Cada CODIA identifica una variante y aparece una sola vez, aunque esté disponible en varios años. Usá el id como versionId para consultar esos años.

Las líneas comerciales se mantienen separadas: 1.3 PRECISION CVT L/25 tiene CODIA 170892 y L/26 1.3 PRECISION CVT tiene CODIA 170915. Ambas están disponibles en 2026.

Consultar años

Devuelve los años disponibles para una versión, de mayor a menor. El único parámetro obligatorio es versionId. Por ejemplo, para Fiat Cronos 1.3 PRECISION CVT L/25 (CODIA 170892):

Terminal

curl 'https://api.clasific.ar/v2/catalog/years?versionId=ia_170892' \
  -H 'x-api-key: <TU_API_KEY>'

Respuesta HTTP 200:

JSON

{
  "data": [
    2026,
    2025
  ],
  "meta": {
    "catalogVersion": "cat_9fbed2e872381f2fd54e92f9"
  }
}

Los años son números y corresponden a la versión identificada por ese CODIA. La cobertura depende de cada versión y puede tener años intermedios sin datos.

Formato de las respuestas

Cada endpoint devuelve la lista completa que corresponde a los parámetros enviados, sin paginación. Los ejemplos anteriores usan datos reales del catálogo; las listas de marcas y modelos están abreviadas.

Marcas y modelos incluyen id y name; las versiones agregan codia. Conservá los IDs y el CODIA como strings. Usá los IDs devueltos por la API, sin construirlos a partir de los nombres. Cada ID de modelo identifica un modelo entre todas las marcas y se mantiene entre actualizaciones del catálogo. Cada ID de versión identifica una variante CODIA; códigos distintos pueden compartir el mismo nombre. Tratá los IDs como valores opacos y enviá los parámetros con la codificación URL habitual.

meta.catalogVersion identifica la revisión del catálogo. Si cambia entre consultas relacionadas, volvé a consultar los IDs utilizados para trabajar con la misma revisión. Las respuestas usan Cache-Control: no-store.

Una marca o un modelo válido sin resultados devuelve data: []. Un ID inexistente devuelve 404 catalog_not_found.

Si integraste el contrato anterior, volvé a obtener los IDs desde /models: los códigos locales como 52 fueron reemplazados por IDs únicos como mdl_17_52. En /versions enviá sólo modelId y en /years sólo versionId; los parámetros anteriores adicionales devuelven 400.

El catálogo describe vehículos y sus años disponibles. No incluye precios ni cotizaciones.

Sandbox y errores

Para probar en Sandbox, usá https://sandbox.clasific.ar con la misma API key de tu cuenta paga. Los IDs de prueba son demo-brand, mdl_demo-brand_demo-model e ia_000001. La versión incluye codia: "000001" y el endpoint de años devuelve [2026, 2024, 2023]. Son datos sintéticos, con catalogVersion: cat_demo_v3.

Los parámetros obligatorios son los mismos en ambos ambientes. No se aceptan parámetros adicionales ni repetidos.

Sandbox y errores
HTTP	Código	Descripción
400	invalid_request	Falta un parámetro obligatorio, su formato es inválido o hay parámetros adicionales o repetidos.
401	invalid_api_key	La API key está ausente, es inválida o fue revocada.
403	access_denied	La cuenta no está habilitada o no tiene un plan con acceso al catálogo.
404	catalog_not_found	El ID consultado no existe en el catálogo de ese ambiente.
429	rate_limit_exceeded	Se alcanzó el límite de requests por minuto. Respetá Retry-After antes de reintentar.
503	temporarily_unavailable	El catálogo no está disponible temporalmente. Reintentá más tarde.

Catálogo de vehículos

Acceso y consumo

Consultar marcas

Consultar modelos

Consultar versiones

Consultar años

Formato de las respuestas

Sandbox y errores

Buscar documentación

Documentación

Acceso y consumo#

Consultar marcas#

Consultar modelos#

Consultar versiones#

Consultar años#

Formato de las respuestas#

Sandbox y errores#

Acceso y consumo

Consultar marcas

Consultar modelos

Consultar versiones

Consultar años

Formato de las respuestas

Sandbox y errores