API FASECOLDA Colombia: valor comercial de referencia y código, por placa

Qué problema resuelve

El valor FASECOLDA es la referencia de mercado para asegurar y avaluar vehículos, pero consultarlo exige conocer el código FASECOLDA exacto por marca, línea y modelo. Esta API lo resuelve a partir de la placa: identifica el vehículo en el RUNT y devuelve el código y el valor de referencia.

Para quién sirve

Aseguradoras, compraventas de usados y fintechs de crédito que necesitan un avalúo de referencia rápido a partir de la placa.

Datos requeridos

• placa — placa del vehículo (ej. ABC123).
• docType y docNumber — documento del propietario (ej. CC 1020304050); se usa para identificar el vehículo en el RUNT y derivar marca/línea/modelo.

Fuentes y cobertura

• FASECOLDA (fasecolda.com)Guía de valores comerciales por marca, línea y modelo.
• RUNTIdentificación del vehículo (marca, línea, modelo) para resolver el código FASECOLDA.

¿Cómo obtener el código FASECOLDA a partir de la placa?

Con PlacApi (placapi.com), en una sola llamada: POST /api/avaluo recibe la placa y el documento del propietario y devuelve el código FASECOLDA en data.codigo, con el valor comercial de referencia y la ficha técnica, en una mediana de 2,3 segundos medida en producción. No hace falta cruzar a mano marca, línea y cilindraje contra la guía, que es donde se rompen las integraciones que lo intentan por nombre: el RUNT no publica el código FASECOLDA, y el puente confiable entre el registro y la guía es el VIN. PlacApi toma el VIN de la ficha del RUNT, lo resuelve contra la guía de valores y entrega la versión exacta, junto con data.codigoHomologado: el código equivalente que la guía publica para el mismo vehículo bajo otro número, siempre distinto del propio.

El documento del propietario no es un trámite de más: es lo que el RUNT exige para decir a qué vehículo corresponde esa placa, igual que en el resto de la API. De la misma ficha salen la marca, la línea, el cilindraje y el año del modelo, que son los que sostienen el respaldo cuando el VIN no alcanza.

Con el código ya en la respuesta, una consulta posterior del mismo vehículo puede entrar directo por POST /api/avaluo-por-codigo: llega en segundos, porque no vuelve a pasar por el RUNT ni pide de nuevo el documento del propietario. Es el camino natural para un sistema que ya guarda el código junto al vehículo —una aseguradora que lo anota en la póliza, un cotizador que ya identificó la versión— y solo necesita el precio.

El campo data.origen dice cómo se identificó el vehículo para llegar a ese código: vin cuando FASECOLDA decodificó el chasis, el caso normal, y catalogo cuando el decodificador todavía no conoce ese chasis —le pasa a buena parte de los modelos 2025 en adelante— y PlacApi resuelve el código por un respaldo que busca en el mismo catálogo público por marca, año, línea y cilindraje. Con origen catalogo, data.aproximado avisa si esa búsqueda dejó más de una versión posible, y data.versionesConsideradas dice cuántas.

¿Qué devuelve la API además del valor?

Junto con el valor comercial, la respuesta trae fichaTecnica: 38 campos que la guía FASECOLDA publica para esa versión, agrupados en motor y mecánica (cilindraje, potencia, combustible, transmisión, tracción), dimensiones y capacidades (peso, largo, ejes, puertas, pasajeros, carga), seguridad (airbags, ABS, frenos, dirección, faros) y equipamiento (aire acondicionado, sunroof, cámara de reversa, sensores de parqueo, tapicería en cuero, vidrios y espejos eléctricos), más la clasificación del gremio (clase, categoría, tipología, servicio, nacionalidad, si es importado). Es la misma ficha que devuelven /api/avaluo-por-codigo y /api/catalogo: no cuesta una consulta ni un crédito aparte.

En fichaTecnica, null y false no dicen lo mismo. null significa que la guía no publica ese dato para este vehículo —no es que valga cero ni que el carro no lo tenga, es que FASECOLDA no lo reportó—. false sí es una afirmación: el vehículo no tiene ese equipamiento. Confundirlos hace que un campo como sunroof: null se lea como «no trae techo corredizo» cuando en realidad la guía simplemente no dice nada al respecto.

rangoMercado trae un mínimo y un máximo en pesos. Cuando el vehículo queda identificado en una sola versión exacta —el caso normal, por VIN o por código— el rango colapsa en el propio valor: min y max son el mismo número, porque no hay otra versión entre la que repartir la diferencia. La variación año a año de esa misma versión viaja aparte, en valoresPorAnio: una lista con el valor comercial y el estado publicado para cada año de modelo, útil para comparar la depreciación de una versión sin repetir la consulta.

¿Es la API oficial de FASECOLDA?

No. FASECOLDA no ofrece una API pública: el único acceso automatizado oficial a su guía de valores es el de Inverfas S.A., reservado a aseguradoras afiliadas. PlacApi tampoco es Inverfas ni tiene vínculo con el gremio asegurador: es un servicio independiente que consulta la guía de FASECOLDA y la sirve por API, en JSON, con el código, el valor comercial y la ficha técnica en la misma respuesta.

El valor que devuelve esta API es una referencia de mercado, no una certificación: FASECOLDA la describe como de uso voluntario y su guía no reemplaza la negociación entre las partes. Sirve como base habitual para dimensionar el valor asegurado o para calcular una indemnización, pero la política de emisión y de pago —qué tanto se ajusta al valor de la guía, qué depreciación aplica, qué hacer si el propietario no está de acuerdo— la fija cada aseguradora, no PlacApi ni FASECOLDA.

¿Cada cuánto cambia el valor y cuánto dura en caché?

FASECOLDA republica su guía de valores mensualmente: es la cadencia con la que el gremio ajusta los precios de referencia, no algo que PlacApi controle. El endpoint no vuelve a consultar la fuente en cada llamada —el resultado por placa queda en caché 30 días, una cadencia cercana a la mensual de la propia guía, así que reconsultar el mismo vehículo poco después es casi instantáneo y, si el dato viene de caché, la respuesta lo dice con fromCache: true (mode siempre es live o demo).

Cuando hace falta el número más reciente antes de que expiren los 30 días, refresh en true salta la caché y fuerza una consulta nueva contra la fuente. Esa consulta, si trae datos, cobra un crédito igual que cualquier otra: el refresco no es gratis, porque vuelve a pasar por el RUNT y por la guía de valores. Para la mayoría de los usos basta con esperar a que la caché expire por sí sola: un valor de referencia no necesita actualizarse más rápido que la propia guía que lo publica.

¿Cómo integro la guía de valores FASECOLDA en mi software de seguros?

Con la API de PlacApi. Por placa, con /api/avaluo, cuando tu sistema todavía no conoce el código FASECOLDA del vehículo. Directo por código, con /api/avaluo-por-codigo, cuando ya lo guardas junto al vehículo o la póliza. Y con /api/catalogo para poblar un selector de marca, año, referencia y versión y obtener el código desde ahí. Las tres llamadas devuelven el mismo valor comercial de referencia y la misma ficha técnica de 38 campos, sin mantener infraestructura propia. Si tu aseguradora ya está afiliada a FASECOLDA, cuenta además con su propio canal gremial para ese mismo dato.

¿Cómo consultar el avalúo FASECOLDA por API?

Con una llamada POST a /api/avaluo enviando la placa, o a /api/avaluo-por-codigo si ya tienes el código FASECOLDA. La respuesta devuelve en JSON el valor comercial de referencia del vehículo, su código FASECOLDA y la ficha técnica de 38 campos, lista para integrar sin procesos manuales.

Ejemplo de solicitud

POST https://placapi.com/api/avaluo. 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' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"placa":"ABC123","docType":"CC","docNumber":"1020304050"}'

Parámetros, errores y ejemplos en cURL, JavaScript y Python: documentación de POST /api/avaluo.

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": "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"
      }
    ],
    "origen": "vin",
    "fichaTecnica": {
      "cilindraje": 2488,
      "potencia": 186,
      "transmision": "4X4",
      "traccion": "DOBLE",
      "airbags": 7,
      "abs": true,
      "sistemaAlimentacion": null,
      "aireAcondicionado": true,
      "tapiceriaCuero": true,
      "segmentoTamano": "C"
    }
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z"
}

Explicación campo por campo

Limitaciones y posibles errores

• El valor FASECOLDA es una referencia de mercado, no un precio de venta ni un avalúo pericial.
• El decodificador de VIN de FASECOLDA no cubre bien los modelos 2025 en adelante; para esos casos el avalúo cae a un respaldo por catálogo (data.origen: "catalogo") que identifica un grupo de versiones compatibles, no una exacta, y por eso trae data.aproximado en true.
• El avalúo depende de identificar el vehículo en el RUNT (marca, línea, modelo); sin esa identificación no se resuelve el código.
• PlacApi no fija precios; reporta el valor de referencia de FASECOLDA.

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

Otras preguntas frecuentes

Seguir explorando

• Documentación del endpoint POST /api/avaluo→
• API de consulta full: avalúo, RUNT, SIMIT e impuesto en una llamada→
• API de consulta vehicular (ficha RUNT)→
• API impuesto vehicular→
• API SIMIT (multas)→
• Verificar un usado antes de comprar→
• Catálogo de marcas, modelos y versiones→
• Precios por consulta→
• API de pérdida total y siniestros→
• Avalúo por código FASECOLDA, sin placa→
• Consultar el avalúo comercial por placa (web)→
• Documentación del endpoint POST /api/avaluo-por-codigo→
• FASECOLDA por placa: guía de valores y código→