Endpoint: avalúo comercial FASECOLDA

/api/avaluo consulta, a partir de la placa de un vehículo colombiano, el valor comercial de referencia que publica la Guía de Valores de FASECOLDA. La respuesta trae el código FASECOLDA de esa versión, su código homologado, marca, línea, modelo, valor en pesos y la ficha técnica completa que registra la guía. Pide también el documento del propietario: no lo exige FASECOLDA, lo exige el RUNT para entregar los datos del vehículo. Si ya conoces el código, el endpoint de avalúo por código llega al mismo resultado sin ese paso.

¿Qué devuelve /api/avaluo y por qué pide el documento?

La placa identifica el vehículo, pero el RUNT —que resuelve marca, línea, modelo y VIN antes de llegar a FASECOLDA— exige también el documento del propietario para entregar esos datos; es una regla del RUNT, no de la guía de valores, y el documento no participa en el cálculo del valor.

La respuesta trae codigo (el código FASECOLDA de esa versión), codigoHomologado (el código que la guía publica como homólogo del propio, siempre distinto), marca, linea, modelo, valorComercial en pesos, clase y fichaTecnica. El valor es de referencia del gremio asegurador: si una aseguradora cotiza otra cifra, lo primero a descartar es que tomó otra versión del mismo modelo.

¿Cómo obtengo el código FASECOLDA de un vehículo a partir de la placa?

Sí: /api/avaluo devuelve el código FASECOLDA de la placa consultada en el campo codigo de la respuesta —junto con codigoHomologado, el código homólogo que publica la guía para el mismo vehículo—, sin ningún paso ni endpoint adicional. Es el flujo completo para resolver placa a código: se manda la placa y el documento una sola vez y se obtiene el código para todo lo que siga.

Desde ahí, cualquier consulta posterior de esa misma versión puede ir directa a avalúo por código, sin volver a pasar por el RUNT. Es el mismo código que trae cada versión del catálogo de marcas, modelos y versiones, y el que aceptan las landings de API FASECOLDA Colombia y de avalúo por código FASECOLDA.

origen dice cómo se identificó la versión: vin cuando FASECOLDA decodifica el chasis con precisión, o catalogo cuando no puede y el endpoint la resuelve por marca, año, línea y cilindraje contra el mismo catálogo de /api/catalogo. Pasa casi siempre con los modelos más nuevos: una medición sobre 120 VIN reales de producción (14-ago-2026) encontró decodificación completa en 54 de 54 vehículos 2018-2023, 4 de 5 en 2024, y solo 0 de 5 en 2025 y 1 de 9 en 2026.

Desde la versión 0.48.0, cuando el VIN falla el avalúo cae al catálogo en vez de devolver vacío —recuperó 31 de 32 fichas de vehículos 2025 en adelante—. Con origen: "catalogo", aproximado avisa si la combinación dejó más de una versión posible, y versionesConsideradas dice cuántas entraron en el rango (un número, no una lista).

¿Qué son rangoMercado y valoresPorAnio?

Los dos describen el mismo valor desde ángulos distintos. rangoMercado es la dispersión de precio en el mismo año: por vin el rango colapsa en el propio valorComercial; por catalogo, con aproximado en verdadero, cubre el mínimo y el máximo de valor entre las versiones que se consideraron —versionesConsideradas dice cuántas fueron—. valoresPorAnio es la curva de esa versión en varios años, útil para estimar depreciación.

rangoMercado y versionesConsideradas según el origen
Campoorigen: "vin"origen: "catalogo"
rangoMercadomínimo = máximo = valorComercialmínimo y máximo entre las versiones consideradas
aproximadofalsetrue si hay más de una versión posible
versionesConsideradas1 (versión única)número de versiones que entraron en el rango

¿Qué trae fichaTecnica?

fichaTecnica agrupa el detalle en cinco bloques: motor y transmisión (cilindraje, potencia, combustible, tracción), dimensiones y capacidades (peso, largo, puertas, pasajeros, carga), seguridad (airbags, ABS, frenos, dirección), equipamiento (aire acondicionado, sunroof, cámara de reversa, sensores, tapicería en cuero) y clasificación del gremio (clase, categoría, tipología, servicio, nacionalidad).

Un campo en null quiere decir que la guía no publica ese dato para esa versión, no que el vehículo no lo traiga; un campo en false sí es una afirmación, la guía confirma que no lo tiene. El resultado se guarda en caché 30 días, el mismo plazo que avalúo por código y alineado con la publicación mensual de la guía; refresh en el body fuerza una consulta viva, y una consulta refrescada con datos siempre cobra crédito.

POST/api/avaluo1 crédito

Valor comercial FASECOLDA por placa: código FASECOLDA, marca, línea, modelo (año), valor comercial en pesos, clase y la ficha técnica completa en fichaTecnica (38 campos: motor, dimensiones, capacidades, seguridad, equipamiento y clasificación — los mismos de /api/avaluo-por-codigo). El VIN y el modelo se resuelven primero desde el RUNT, así que la placa basta. origen dice cómo se identificó el vehículo: vin (exacto) o catalogo (marca + año + línea + cilindraje, cuando FASECOLDA no decodifica el chasis — le pasa a los modelos nuevos); con catalogo, aproximado avisa si quedó más de una versión posible y rangoMercado cubre todas. Por vin la versión es única, así que rangoMercado colapsa en el propio valor; la curva año por año de esa versión viaja aparte en valoresPorAnio. Valor de referencia del gremio asegurador, no un avalúo pericial: si una aseguradora cotiza otra cifra, lo primero a descartar es que haya tomado otra versión del mismo modelo. codigoFoto trae los identificadores de la imagen que la guía archiva para esa versión —lista vacía si no tiene ninguna—: el nombre del archivo no siempre corresponde al código, así que no se puede deducir.

Cuerpo de la solicitud

body (JSON)
{
  "placa": "ABC123",
  "docType": "CC",
  "docNumber": "1020304050"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
placaobligatoriostringPlaca del vehículo. 5 a 7 caracteres alfanuméricos: cubre AAA000, AAA00A y los formatos menos comunes (AAA00, AAAA00). Los guiones y espacios se ignoran. Si la mandas dentro del alias interno de tu flota (`ABC12D_JPG`, `ABC12D-JUAN-PEREZ`, `ABC12D-MOVIL-11`) se extrae la placa, siempre que en el texto haya UNA sola: con dos o con ninguna la respuesta es 400.
docTypeobligatoriostringTipo de documento del propietario (CC, CE, NIT, PA, TI, CD, PPT, RC). Se aceptan alias comunes: PAS y PASAPORTE se normalizan a PA, y P.P.T. y P.P. —como lo abrevia la tarjeta de propiedad— se normalizan a PPT.Valores: CC · CE · NIT · PA · TI · CD · PPT · RC
docNumberobligatoriostringNúmero de documento del propietario. Alias aceptado: `doc`.
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' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"placa":"ABC123","docType":"CC","docNumber":"1020304050"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/avaluo", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"placa":"ABC123","docType":"CC","docNumber":"1020304050"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/avaluo",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"placa":"ABC123","docType":"CC","docNumber":"1020304050"},
)
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

¿El avalúo FASECOLDA es lo mismo que el resultado de pérdida total?
No. /api/avaluo dice cuánto vale un vehículo; /api/perdida-total dice si tuvo una reclamación de pérdida total. Un vehículo puede tener valorComercial alto y estar reportado como pérdida total al mismo tiempo.
¿Pide algún dato distinto a la placa y el documento?
No. Solo placa, docType y docNumber, igual que el resto de endpoints vehiculares de PlacApi; el documento identifica al propietario ante el RUNT y no interviene en el cálculo del valor comercial.
¿Qué pasa si la placa no tiene código FASECOLDA?
No responde 404: la API entrega 200 con data en null y el motivo en error, por ejemplo «No se encontró un avalúo para este vehículo». Al no haber datos, la consulta no descuenta crédito. Pasa con vehículos muy antiguos o importaciones atípicas; reintentar con los mismos datos da el mismo resultado.
¿Para qué sirve codigoHomologado si ya tengo codigo?
La guía publica para cada código un homoloCodigo siempre distinto del propio, y la API lo entrega tal cual en codigoHomologado, sin interpretarlo. Es una pista sobre versiones hermanas del mismo vehículo, no resuelve por sí sola cuál es la versión exacta.

¿Para qué se usa?

  • Aseguradoras y corredores: tarifar una póliza todo riesgo con el valor asegurable de la versión exacta, no de un promedio de la línea.
  • Peritos y ajustadores: punto de partida documentado para un dictamen de indemnización.
  • Concesionarios y compraventa: tasar un vehículo recibido en parte de pago contra el valor de referencia del gremio.
  • Financieras: valorar la garantía de un crédito prendario.

El avalúo FASECOLDA no es el impuesto vehicular: el impuesto se liquida con la base gravable que fija el Ministerio de Transporte, no con esta guía; para eso existe la consulta de impuesto vehicular por placa.

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

Contacto