API de avalúo FASECOLDA por código: valor comercial sin pasar por la placa

Qué problema resuelve

La guía de valores de FASECOLDA es la referencia con la que el mercado asegurador colombiano tasa un vehículo, pero el gremio no publica una API para consultarla: hay que entrar a su buscador, elegir categoría, marca, referencia y versión, y leer el número a mano. Un perito que valora treinta vehículos al día no puede repetir eso treinta veces, y una aseguradora que ya guarda el código FASECOLDA en su póliza tampoco quiere volver a identificar el carro desde cero: el código es un identificador exacto y basta con preguntarle su precio. Este endpoint hace justo eso, en una llamada y sin captcha.

Para quién sirve

Aseguradoras y corredores que ya tienen el código FASECOLDA en su cotizador, peritos y ajustadores que valoran por versión exacta, entidades de leasing y crédito que tasan garantías, y desarrolladores que construyen un selector de marca, modelo y versión y necesitan el precio del ítem que el usuario acaba de elegir.

Datos requeridos

• codeFasecolda — código de la guía de valores FASECOLDA, solo dígitos (por ejemplo 08053096). Alias aceptado: codigo.
• modelo — opcional: año del modelo. Ajusta el valor comercial al año pedido, porque una misma versión no vale lo mismo en 2019 que en 2024.
• refresh — opcional: salta la caché y vuelve a preguntarle a la fuente. Una consulta refrescada con datos siempre cobra.

Fuentes y cobertura

• FASECOLDA (fasecolda.com)Guía de valores del gremio asegurador: valor comercial y rango de mercado por código, marca, referencia, versión y año del modelo. Es la referencia con la que las aseguradoras dimensionan el valor asegurable.
• Catálogo público de FASECOLDAEl mismo catálogo que alimenta /api/catalogo: marcas, años, referencias y versiones, cada una con su código, su valor de mercado y su ficha técnica. Es de donde sale el código cuando no se tiene.

¿Cuándo conviene consultar por código y cuándo por placa?

PlacApi tiene dos endpoints para el mismo dato y la diferencia no es cosmética: es por dónde entra la consulta. /api/avaluo-por-codigo recibe el código de la guía y pregunta el precio de esa versión exacta. /api/avaluo recibe la placa y el documento del propietario, y antes de poder preguntar nada tiene que averiguar de qué vehículo se trata: consulta el RUNT, saca el VIN, la marca, la línea, el cilindraje y el año, y solo entonces resuelve el código. Son dos productos para dos situaciones y ninguno reemplaza al otro.

El costo en créditos es el mismo —1 crédito por consulta con datos— pero el tiempo no. Por código la respuesta llega en segundos, porque hay un solo salto contra la fuente. Por placa hay que esperar primero al RUNT, que es un portal con captcha y el eslabón lento de toda la cadena. Si tu sistema ya guarda el código junto al vehículo, pagar la resolución de placa a código en cada cotización es pagar dos veces por algo que ya sabías.

La otra diferencia es la precisión. El código identifica una versión concreta: un Corolla híbrido con caja automática es un código y el de gasolina con caja mecánica es otro, con otro precio. Entrando por placa, la versión hay que deducirla de lo que publica el RUNT, que es menos específico que la guía; cuando esa deducción deja más de una versión posible, la respuesta lo confiesa y el rango cubre todas. Entrando por código no hay nada que deducir.

¿De dónde sale el código FASECOLDA y qué hago si no lo tengo?

El código FASECOLDA es un identificador numérico que la guía de valores le asigna a cada versión de cada vehículo. No está impreso en la tarjeta de propiedad ni lo publica el RUNT: sale del catálogo de la propia FASECOLDA. Por eso PlacApi expone /api/catalogo, un endpoint en cascada que recorre ese catálogo hasta llegar al código, y que no pide placa ni documento de nadie.

La cascada tiene tres pasos: sin filtros devuelve las marcas y los años disponibles; con una marca, sus referencias; con marca más año —o más referencia— las versiones. Cada versión llega con su código, su valor de mercado, el precio de vehículo nuevo cuando ese año todavía se vende 0 km, y la ficha técnica: cilindraje, potencia, puertas, airbags y tracción. Es lo que hace falta para poblar un selector de marca, modelo y versión, y el código que sale de ahí es el que acepta este endpoint.

Dos detalles del catálogo que ahorran una tarde de depuración. El primero: en el catálogo vehicular colombiano «modelo» es el año, no la línea, así que modelo 2024 significa año 2024 y la línea va en referencia. El segundo: el filtro soloConPrecio viene activado por defecto y esconde las versiones sin valor publicado para ese año; apagarlo hace que Toyota 2024 pase de 44 a 401 versiones, casi todas en cero. El recorrido completo, paso por paso, está en la referencia del catálogo vehicular.

¿Por qué el VIN de FASECOLDA no cubre los modelos 2025 en adelante?

Esta es la limitación real de la guía y conviene conocerla antes de diseñar la integración, porque explica por qué el código es un camino más firme que el chasis. El decodificador de VIN de FASECOLDA no tiene cargados los vehículos de los años-modelo más recientes: para esos VIN responde con un error, no con un código, y sin código no hay precio.

El corte está medido. Sobre 120 VIN reales tomados de nuestra propia caché el 14 de agosto de 2026, el decodificador resolvió 54 de 54 en los modelos 2018 a 2023 y 4 de 5 en 2024, y a partir de ahí se cae: 0 de 5 en 2025, 1 de 9 en 2026 y 0 de 1 en 2027. No es la fuente caída —un VIN de control de 2022 respondía bien en el mismo minuto— ni un problema de credenciales, y tampoco es que el vehículo no tenga precio: el Mazda CX-30 modelo 2026 sí está en la guía, con valores publicados por versión. Lo único roto es el puente entre el VIN y el código.

Consultando por código ese puente no existe, así que la limitación no aplica: un vehículo 2026 tiene código y tiene precio, y este endpoint lo devuelve igual que uno de 2015. Del lado de la consulta por placa el hueco se cubrió en agosto de 2026 con un respaldo que identifica el vehículo por marca, año, línea y cilindraje contra el mismo catálogo público; con eso las fichas de modelo 2025 o posterior pasaron de 0 de 32 a 31 de 32 con avalúo. Ese respaldo identifica un grupo compatible, no la versión exacta, y por eso la respuesta de /api/avaluo lo rotula con el campo origen: vin cuando resolvió el chasis y catalogo cuando resolvió el respaldo.

¿Qué es el rango de mercado que viene junto al valor?

Junto al valor comercial la respuesta trae un rango con un mínimo y un máximo en pesos. No es una estimación nuestra: es la banda que publica la propia guía para esa versión y ese año, y refleja que dos vehículos idénticos sobre el papel no valen lo mismo en la calle según estado, kilometraje y equipamiento.

Para un asegurador, el valor comercial es el número con el que normalmente se dimensiona el valor asegurable y el rango es lo que permite defender una cifra distinta cuando el vehículo lo justifica. Para un cotizador de crédito, el mínimo del rango es la lectura conservadora de la garantía. PlacApi no fija ninguno de los tres números: reporta lo que FASECOLDA publica. Por eso un valor de referencia no sustituye a un avalúo pericial cuando hay una disputa de por medio.

¿Cómo consultar el avalúo FASECOLDA por código con una API?

Con una llamada POST a /api/avaluo-por-codigo enviando codeFasecolda, el código numérico de la guía de valores, y opcionalmente modelo con el año. La autenticación va en el header x-api-key. La respuesta devuelve en JSON la marca, la referencia, el año, la clase, el valor comercial en pesos y el rango de mercado. No hace falta placa, ni documento del propietario, ni que el vehículo esté matriculado en Colombia.

¿En qué se diferencia de la API de avalúo por placa?

En la entrada. /api/avaluo-por-codigo recibe el código y pregunta el precio de esa versión exacta. /api/avaluo recibe placa y documento del propietario, consulta primero el RUNT para identificar el vehículo y con eso resuelve el código. Cuestan lo mismo, 1 crédito, pero el de placa es más lento porque depende del RUNT y su versión es deducida, no exacta. Ese camino está documentado en la página de la API FASECOLDA por placa.

Ejemplo de solicitud

POST https://placapi.com/api/avaluo-por-codigo. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.

curl -X POST 'https://placapi.com/api/avaluo-por-codigo' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"codeFasecolda":"08053096","modelo":2023}'

Ejemplo de respuesta

Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).

{
  "source": "avaluo",
  "status": "info",
  "data": {
    "codigo": "08053096",
    "marca": "MAZDA",
    "linea": "CX-30",
    "modelo": 2023,
    "valorComercial": 98000000,
    "rangoMercado": {
      "min": 92000000,
      "max": 104000000
    },
    "clase": "CAMIONETA"
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z"
}

Explicación campo por campo

Limitaciones y posibles errores

• El valor FASECOLDA es una referencia del gremio asegurador, no un precio de venta ni un avalúo pericial. PlacApi reporta lo que la guía publica; no fija precios.
• Un código inexistente, o sin valor publicado, responde HTTP 200 con data en null y status unknown. Esa consulta no cobra crédito, pero tampoco devuelve un valor aproximado: preferimos el hueco declarado a un número inventado.
• El endpoint no verifica que el código corresponda a un vehículo real matriculado: recibe un código y devuelve su precio. Un código mal digitado que igual exista en la guía devolverá una respuesta correcta para OTRO vehículo; comprobar esa correspondencia es de quien integra.
• El decodificador de VIN de FASECOLDA no cubre los años-modelo 2025 en adelante. Esto no afecta a este endpoint, que no usa VIN, pero sí a /api/avaluo, que resuelve la placa por VIN antes de caer al respaldo por catálogo.
• El avalúo queda en caché 180 días. Si FASECOLDA republica su guía antes de ese plazo, el valor anterior sigue vigente hasta que la consulta se pida con refresh.

Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.

Otras preguntas frecuentes

Seguir explorando

• API FASECOLDA por PLACA: el avalúo cuando solo tienes la placa→
• Catálogo vehicular: de marca y modelo al código FASECOLDA→
• Consultar el avalúo FASECOLDA por placa, sin código→
• API de consulta vehicular: la ficha del RUNT→
• API de impuesto vehicular por placa→
• Sandbox, API key y documentación→