Endpoint: avalúo FASECOLDA por VIN

/api/avaluo-por-vin devuelve el valor comercial de referencia y la ficha técnica completa de un vehículo a partir de su número de chasis, sin placa y sin el documento del propietario. Es la entrada natural para quien tiene el vehículo o la tarjeta de propiedad delante —aseguradoras, peritos, concesionarios— y no necesita que un registro le diga primero qué vehículo es.

¿Por qué existe una entrada por VIN?

El valor de referencia se identifica por versión de vehículo, y el número de chasis es lo que apunta a una versión exacta: mismo modelo, mismo año, mismo acabado. En el avalúo por placa la placa y el documento del propietario existen para llegar a ese número; quien ya lo tiene en la mano se ahorra ese paso entero, con tres consecuencias prácticas:

  • Responde más rápido, porque se elimina la consulta al registro nacional, que es el tramo lento de la cadena.
  • No falla por el documento. El error más común del avalúo por placa no es del valor: es que el documento enviado no corresponde al propietario activo del vehículo, y entonces no hay ficha de la que sacar el chasis.
  • Sirve para vehículos que aún no tienen placa asignada —importaciones en trámite, inventario de concesionario— siempre que el chasis esté en la guía.

Cuándo hay que mandar marca, línea, año y cilindraje

Son opcionales, pero no son decorativos. La guía tarda en incorporar los chasis de los modelos recién salidos: hoy prácticamente ningún vehículo de modelo 2025 en adelante se puede decodificar por su número de chasis, y ese es justamente el segmento donde más se pide un valor asegurable.

Para esos casos el endpoint tiene un segundo camino: identificar el grupo de versiones compatible con marca, linea, modelo (el año) y cilindraje. Con eso responde un valor representativo del grupo. Sin ellos no adivina: una marca y un año enteros no son un avalúo, así que la respuesta sale con data en null y sin cobrar.

Cuando el chasis sí se decodifica, las pistas se ignoran: no hay riesgo en mandarlas siempre. La recomendación para una integración es enviarlas cada vez que se tengan, que es casi siempre —vienen en la tarjeta de propiedad—.

Cómo saber por cuál de los dos caminos respondió

La respuesta lo dice sola, y conviene leerlo antes de mostrarle la cifra a un cliente:

  • origen: "vin" — el chasis identificó una versión única. rangoMercado colapsa en el propio valor porque no hay dispersión que publicar, y la curva año por año de esa misma versión viaja en valoresPorAnio.
  • origen: "catalogo" — respondió el respaldo por grupo. Ahí aproximado avisa si quedó más de una versión posible, versionesConsideradas dice cuántas eran y rangoMercado las cubre todas.

Un valor con aproximado: true es un estimado del grupo, no de la versión exacta: presentarlo como cifra cerrada es la forma más fácil de tener una discusión con el cliente que no hacía falta.

Si la aseguradora cotiza otra cifra

Antes de sospechar del dato, descartar el acabado. Un mismo modelo y año suele tener dos o tres versiones con códigos distintos, y el escalón entre ellas explica casi todas las diferencias que parecen inexplicables: en un caso medido, una camioneta de 2022 tenía dos versiones separadas por un 12,4 %, y la aseguradora había tomado la de arriba. No era un error de nadie: eran dos vehículos distintos en la guía.

Esto importa comercialmente. Un vehículo asegurado como una versión superior a la real está en sobreseguro: se paga más prima y, en pérdida total, la indemnización se calcula sobre el valor real, no sobre el asegurado. Para comparar acabados, el catálogo de versiones lista los códigos del mismo modelo y año con su valor cada uno.

La ficha técnica viene incluida

La misma llamada devuelve fichaTecnica con 38 campos —motor, transmisión y tracción, dimensiones y capacidades, seguridad, equipamiento y clasificación— sin costo ni petición adicional.

Un detalle que cambia cómo se lee: la fuente no deja campos vacíos cuando no tiene el dato, usa marcadores, y no todos significan lo mismo —una cosa es «el vehículo no lo trae» y otra «no se conoce»—. En fichaTecnica eso ya viene traducido: todo lo que sea «no se sabe» sale como null, y solo false afirma que el vehículo no tiene ese atributo. Tratar los dos como equivalentes es certificar ausencias que la fuente nunca afirmó.

¿Cuál de los tres avalúos usar?

  • Tengo el chasis → este endpoint. La ruta más corta y la que no depende del documento del propietario.
  • Tengo la placa y el documento → avalúo por placa, que resuelve el chasis y las pistas por su cuenta antes de valorar.
  • Tengo el código de la versión → avalúo por código, la entrada directa cuando el vehículo ya está normalizado en el sistema de quien consulta.

Los tres devuelven la misma forma de respuesta y cuestan lo mismo: cambian en qué hay que tener para preguntar.

POST/api/avaluo-por-vin1 crédito

Valor comercial FASECOLDA y ficha técnica completa por VIN (número de chasis), sin placa ni documento del propietario. Misma respuesta que /api/avaluo —código FASECOLDA, marca, línea, modelo (año), valor comercial en pesos, clase, fichaTecnica con sus 38 campos, valoresPorAnio y codigoFoto— pero entrando directo: FASECOLDA siempre se consultó por VIN, y en la versión por placa el documento del propietario existe solo para que el registro nacional devuelva ese número. Quien ya lo tiene a la vista se ahorra ese paso, su espera y su modo de falla más común (el documento que no corresponde al propietario activo). ⚠️ FASECOLDA no decodifica los VIN de los modelos nuevos (medido: ninguno de los 2025, uno de cada nueve de 2026). Para esos casos existe el respaldo por catálogo, que identifica el grupo compatible con marca + año + línea + cilindraje: por eso este endpoint acepta esos cuatro datos como campos opcionales. Mandarlos es la diferencia entre recibir un avalúo aproximado y no recibir ninguno en un vehículo 0 km; con un VIN que la fuente sí decodifica se ignoran. origen dice cuál de los dos caminos respondió (vin o catalogo) y, con catalogo, aproximado avisa si quedó más de una versión posible y rangoMercado las cubre todas. Valor de referencia del gremio asegurador, no un avalúo pericial. Un VIN que no resuelve por ningún camino responde data: null y no cobra. Cuesta 1 crédito por consulta con datos.

Cuerpo de la solicitud

body (JSON)
{
  "vin": "9GAJC6915FB040270"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
vinobligatoriostringVIN o número de chasis: 11 a 17 caracteres, sin las letras I, O ni Q (el estándar las excluye para no confundirlas con 1 y 0). El rango llega hasta 11 porque las motos y los vehículos viejos traen series más cortas que el VIN moderno de 17. Alias aceptado: `chasis`.
marcastringMarca del vehículo. Solo se usa si FASECOLDA no decodifica el VIN; entonces es obligatoria de hecho para que el respaldo por catálogo encuentre algo.
lineastringLínea o referencia tal como la nombra la tarjeta de propiedad (`CX-30`, `NS 200`). Sin línea el respaldo no adivina: una marca y un año enteros no son un avalúo.
modelonumberAño del modelo. En el catálogo vehicular colombiano «modelo» es el año, no la línea. Con el camino por VIN ajusta el valor al año pedido.
cilindrajenumberCilindraje en centímetros cúbicos. Acota el grupo de versiones cuando el respaldo por catálogo tiene que elegir.
clasestringClase del vehículo (`AUTOMOVIL`, `CAMIONETA`, `MOTOCICLETA`…). Orienta la categoría del catálogo, que en la fuente está separada por tipo.
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/avaluo-por-vin' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"vin":"9GAJC6915FB040270"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/avaluo-por-vin", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"vin":"9GAJC6915FB040270"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/avaluo-por-vin",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"vin":"9GAJC6915FB040270"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)
{
  "source": "avaluo",
  "status": "info",
  "data": {
    "codigo": "05636023",
    "marca": "MAZDA",
    "linea": "CX30 GRAND TOURING LX TP 2500CC 7AB R18 TC CT AWD",
    "modelo": 2023,
    "valorComercial": 109100000,
    "rangoMercado": {
      "min": 109100000,
      "max": 109100000
    },
    "clase": "CAMIONETA PASAJ.",
    "codigoHomologado": "05606096",
    "codigoFoto": [
      {
        "id": 49202000,
        "nombre": "1618155-259.jpg"
      }
    ],
    "fichaTecnica": {
      "cilindraje": 2488,
      "potencia": 186,
      "combustible": "GASOLINA",
      "sistemaAlimentacion": null,
      "transmision": "4X4",
      "tipoCaja": "TIPTRONICA",
      "traccion": "DOBLE",
      "peso": 1520,
      "largo": 4395,
      "ejes": 2,
      "puertas": 5,
      "capacidadPasajeros": 5,
      "capacidadCarga": null,
      "airbags": 7,
      "abs": true,
      "frenos": "DISCO/DISCO",
      "tipoDireccion": "ELÉCTRICA",
      "tipoFaros": "LED",
      "suspensionTrasera": null,
      "aireAcondicionado": true,
      "tipoAireAcondicionado": "AUTOMATICO",
      "sunroof": true,
      "camaraReversa": true,
      "sensoresParqueo": true,
      "exploradoras": true,
      "tapiceriaCuero": true,
      "tacometro": null,
      "vidriosElectricos": 4,
      "espejosElectricos": 2,
      "sillasElectricas": 1,
      "clase": "CAMIONETA PASAJ.",
      "categoria": "LIVIANO PASAJEROS",
      "tipologia": "UTILITARIO DEPORTIVO 4X4",
      "servicio": "PARTICULAR",
      "nacionalidad": "MEX",
      "importado": true,
      "segmentoTamano": "C",
      "segmentoCilindraje": "Y"
    },
    "origen": "vin"
  },
  "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.

Preguntas frecuentes

¿Pide la placa o el documento del propietario?
Ninguno de los dos. Solo el VIN, y opcionalmente marca, línea, año y cilindraje, que se usan como respaldo cuando el chasis no se puede decodificar.
¿Qué diferencia hay con el avalúo por placa?
El mismo dato y la misma respuesta, con otra entrada. El avalúo por placa resuelve primero el VIN a partir de la placa y el documento del propietario; aquí ese paso ya está hecho, así que la consulta es más corta y no depende de que el documento coincida con el propietario activo.
¿Sirve para modelos 2025 en adelante?
Sí, pero mandando también marca, línea, año y cilindraje: en los modelos nuevos el chasis todavía no se decodifica y el valor se resuelve por el grupo de versiones compatible con esos cuatro datos. Sin ellos, un vehículo 0 km responde sin avalúo y no cobra.
¿Cuánto cuesta y cada cuánto se refresca?
1 crédito por consulta que trae datos; una respuesta servida desde caché no descuenta crédito. La caché dura 30 días, alineada con la publicación mensual de la guía, y refresh la salta.
¿Acepta números de chasis de moto, más cortos que 17?
Sí. Se admiten de 11 a 17 caracteres, sin las letras I, O ni Q, porque las motos y los vehículos antiguos traen series más cortas que el VIN moderno.

¿Para qué se usa?

  • Aseguradoras y corredores cotizando con la tarjeta de propiedad a la vista, donde el chasis está impreso y el documento del tomador no siempre es el del propietario registrado.
  • Peritos y ajustadores con el vehículo delante: el chasis se lee en el propio vehículo, sin depender de que la placa esté legible o vigente.
  • Concesionarios e importadores valorando inventario que todavía no tiene placa asignada.
  • Financieras y prendarias que ya guardan el chasis en su expediente de garantía y necesitan revalorar sin volver a pedirle datos al cliente.

Última revisión: 4 de septiembre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto