API FASECOLDA Colombia: valor comercial de referencia por placa

PlacApi ofrece una API REST dedicada para consultar el valor comercial de referencia FASECOLDA de un vehículo colombiano. Con la placa y el documento del propietario, el endpoint /api/avaluo deriva la marca, la línea y el modelo desde el RUNT y devuelve en JSON el valor comercial de referencia y su rango de mercado, útil para tasar un usado o dimensionar una póliza.

Probar en el sandbox y generar API keyVer precios por consulta

¿No eres desarrollador? Consulta el RUNT por placa aquí sin escribir código.

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 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 y los datos con los que se identificó, sin pasar por la guía en PDF ni por el buscador del gremio.

¿El valor FASECOLDA es el precio de venta?

No. Es una referencia de mercado usada por aseguradoras; el precio real depende de estado, kilometraje y negociación.

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.

Ejemplo cURL de la solicitud
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"}'

Ejemplo de respuesta

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

Ejemplo de respuesta JSON
{
  "source": "FASECOLDA",
  "status": "info",
  "data": {
    "codigo": "08053096",
    "marca": "MAZDA",
    "linea": "CX-30",
    "modelo": 2023,
    "valorComercial": 98000000,
    "rangoMercado": {
      "min": 92000000,
      "max": 104000000
    }
  },
  "mode": "live"
}

Explicación campo por campo

CampoTipoDescripción
sourcestringFuente del avalúo; "FASECOLDA".
statusstringEstado de la consulta ("info", "ok", "warn").
data.codigostringCódigo FASECOLDA del vehículo cuando se resuelve.
data.marcastringMarca usada para el avalúo (derivada del RUNT).
data.lineastringLínea usada para el avalúo.
data.modelonumberAño del modelo.
data.valorComercialnumber (COP)Valor comercial de referencia.
data.rangoMercado.minnumber (COP)Extremo inferior del rango de mercado.
data.rangoMercado.maxnumber (COP)Extremo superior del rango de mercado.
modestring"live" si se consultó en tiempo real; "cache" si vino de caché.

Tiempo de respuesta

Entre 30 y 90 segundos la primera vez —es lo que tardan los portales oficiales en responder—. Reconsultar la misma placa es casi instantáneo porque el resultado queda en caché.

Precio y cobro

1 crédito por consulta con datos, desde 349 COP. El precio por crédito baja por volumen: 349 COP desde 30, 249 COP desde 1.000, 149 COP desde 5.000, 139 COP desde 10.000, 119 COP desde 20.000, 99 COP desde 50.000. Los créditos se compran por adelantado (mínimo 30 = 10.470 COP), no vencen y no hay mensualidad. El mismo precio aplica por la web y por API. Solo se cobra cuando la consulta devuelve datos; por API, las consultas sin resultado (404) tienen 10 gratis al mes por cada tipo de respuesta sin datos y después cobran igual.

Caché y actualización

La guía FASECOLDA se actualiza periódicamente; el valor se cachea por días. La clave de caché es solo la placa.

Seguridad y privacidad

La placa y el documento se usan solo para ejecutar la consulta; el resultado queda en caché temporal. No se almacenan datos de tarjetas (los pagos los procesa Wompi). Ver privacidad y seguridad.

Limitaciones y posibles errores

  • El valor FASECOLDA es una referencia de mercado, no un precio de venta ni un avalúo pericial.
  • Algunas versiones poco comunes pueden no tener código exacto en la guía; en ese caso data puede venir sin valor.
  • 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

¿Sirve para calcular la prima del seguro?

+

Es la base habitual para dimensionar el valor asegurado, aunque cada aseguradora aplica su propio criterio.

¿Este endpoint también trae SOAT o multas?

+

No. /api/avaluo devuelve solo el valor FASECOLDA. El SOAT y la tecnomecánica están en /api/consulta (ficha del RUNT) y las multas en /api/multas.

Seguir explorando

Última revisión: 10 de agosto de 2026 · Versión de la API: v1 · Fuentes y metodología

Contacto