Endpoint: avalúo comercial FASECOLDA

Con la placa deriva del RUNT la marca, la línea y el modelo del vehículo y devuelve el valor comercial de referencia que publica FASECOLDA, junto con su rango de mercado. Si ya conoces el código FASECOLDA del vehículo, el endpoint de avalúo por código evita el paso por el RUNT. No confundir con /api/perdida-total, que también sale de FASECOLDA pero responde otra cosa: aquel dice si el vehículo tuvo reclamaciones ante aseguradoras, este dice cuánto vale. Un carro puede tener un avalúo alto y estar reportado como pérdida total.

POST/api/avaluo1 crédito

Valor comercial FASECOLDA y rango de mercado por placa: código FASECOLDA, marca, línea, modelo (año), valor comercial en pesos, rango min/max y clase. 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 el rango cubre todas. Valor de referencia del gremio asegurador, no un avalúo pericial.

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.
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 — datos ficticios de ejemplo
{
  "source": "avaluo",
  "status": "info",
  "data": {
    "codigo": "08053096",
    "marca": "MAZDA",
    "linea": "CX-30",
    "modelo": 2023,
    "valorComercial": 98000000,
    "rangoMercado": {
      "min": 92000000,
      "max": 104000000
    },
    "clase": "CAMIONETA",
    "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.

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

Contacto