Endpoint: avalúo FASECOLDA por código
/api/avaluo-por-codigo devuelve el valor comercial de referencia que publica FASECOLDA a partir del código de ocho dígitos de una versión de vehículo, sin resolver antes ninguna placa. Es la puerta directa para quien ya tiene el código —porque lo sacó del catálogo, de una consulta previa a avalúo por placa, o de su propio sistema— y solo necesita el valor y la ficha técnica, sin pagar el paso de identificar el vehículo contra el RUNT.
¿Qué es el código FASECOLDA y de dónde lo saco?
El código FASECOLDA son ocho dígitos que la guía le asigna a cada versión de vehículo, no a cada vehículo individual: dos autos idénticos del mismo año y versión comparten código. Tres caminos para tenerlo antes de llamar a este endpoint:
- Recorriendo el catálogo de marcas, modelos y versiones hasta la versión exacta, que lo trae en
codigo. - Consultando avalúo por placa, que además del valor devuelve el código y su homólogo
codigoHomologado, siempre distinto. - O el código que ya tengas guardado de una póliza o de una consulta anterior.
Este endpoint acepta codeFasecolda, o su alias codigo, con ese número.
¿Para qué sirve modelo?
modelo es opcional y recibe el año del vehículo. Un mismo código puede tener un valor distinto según el año consultado: la guía no repite el precio anterior, lo recalcula mes a mes. Sin modelo, el endpoint responde con el año más reciente que tenga valor publicado; con él, ajusta la respuesta al año pedido. Sirve para reconstruir la curva de valor de una versión sin resolver el código de nuevo: basta con repetir la llamada al mismo codeFasecolda cambiando el modelo.
¿Qué pasa si el código no existe o no tiene valor ese año?
El endpoint responde 200, no 404: cuando el código no está en el catálogo vigente, o existe pero no tiene valor publicado para el modelo pedido —pasa con versiones descontinuadas o sin ventas registradas ese año—, el cuerpo trae data en null y el motivo en error, por ejemplo «No se encontró un avalúo para ese código».
Como no hay datos que entregar, la consulta no descuenta crédito: queda registrada como sin datos facturables, no como un error del cliente. Otros errores de esta API sí responden con códigos HTTP distintos y reglas de cobro propias —ver errores y rate limits—, pero un código FASECOLDA sin valor no es uno de ellos.
¿Cada cuánto se refresca?
La respuesta se guarda en caché 30 días —igual que avalúo por placa, que usa el mismo plazo—, alineado con que FASECOLDA publica una guía nueva cada mes: ese ciclo cubre la vigencia completa de una publicación sin arriesgarse a servir un valor de dos meses atrás.
refresh en el body salta la caché y fuerza una consulta viva, útil apenas se sabe que la guía del mes ya se actualizó; una consulta refrescada que trae datos cobra crédito aunque la anterior haya salido gratis por venir de caché.
¿Cómo leer fichaTecnica?
La guía de FASECOLDA no deja campos vacíos cuando no sabe un dato: usa palabras o números que hacen de marcador, y esos marcadores no significan lo mismo entre sí. En un campo de texto, un valor señala que el vehículo no trae ese elemento, y otro distinto que la guía no consiguió el dato —dos respuestas a preguntas distintas—. En un número, el marcador es una cifra que ningún vehículo real tendría, como cincuenta y un airbags.
fichaTecnica ya llega con esos marcadores traducidos: cualquier caso de “no se sabe” sale como null, y solo false confirma que el vehículo no trae ese atributo.
Receta de integración: catálogo, código, avalúo
- Selector con el catálogo — marca, luego año, luego versión, para que el usuario elija su vehículo sin escribir texto libre.
- Guardar el
codigode la versión elegida: viene en cada elemento deversiones, sin otra llamada. - Consultar
avaluo-por-codigocon ese código, y opcionalmentemodelo, solo cuando de verdad hace falta el valor, no en cada clic del selector.
El primer paso cuesta 1 crédito por combinación consultada al catálogo, pero su caché dura 7 días: las combinaciones frecuentes casi nunca vuelven a cobrar. Separar el catálogo del avalúo evita gastar crédito en cada paso intermedio de un formulario.
Valor comercial FASECOLDA directo por código, sin resolver placa→código. Para aseguradoras y peritos que ya tienen el código FASECOLDA. Acepta codeFasecolda y opcionalmente modelo (año) para desambiguar el valor.
Devuelve además la ficha técnica completa del vehículo en fichaTecnica (38 campos, sin costo adicional): motor (cilindraje, potencia, combustible), transmisión y 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, exploradoras, tapicería en cuero, vidrios/espejos/sillas eléctricas), más la clasificación del gremio (clase, categoría, tipología, servicio, nacionalidad, importado, segmento).
⚠️ En fichaTecnica, null significa la guía no publica ese dato para este vehículo, y es distinto de false (que sí es una afirmación: no lo tiene). Los campos planos históricos —categoria, tipologia, combustible, transmision, cilindraje— siguen viajando igual que siempre para no romper integraciones; en código nuevo, usar fichaTecnica.
codigoFoto lista los identificadores de las imágenes que la guía tiene de esa versión (id y nombre de archivo), vacío cuando no hay ninguna. Se publica porque el nombre no se deduce del código: sobre 2.860 versiones medidas coincide con codigo en el 90,6% y con codigoHomologado en el 1,2%, pero en el 7,1% no es ninguno de los dos. Una versión puede traer dos entradas (la misma imagen en dos formatos, o dos imágenes distintas) y llegan en el orden de la guía, que no señala cuál es la principal.
Para qué sirve, quién lo usa y cuánto cuesta: API FASECOLDA por código.
Cuerpo de la solicitud
{
"codeFasecolda": "05636023"
}| Campo | Tipo | Qué es |
|---|---|---|
| codeFasecoldaobligatorio | string | Código FASECOLDA del vehículo (numérico). Alias aceptado: `codigo`. |
| modelo | number | Año del modelo; ajusta el valor comercial al año indicado. |
| refresh | boolean | Ignora 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 -X POST 'https://placapi.com/api/avaluo-por-codigo' \
-H 'x-api-key: pk_live_TU_CLAVE' \
-H 'content-type: application/json' \
-d '{"codeFasecolda":"05636023"}'const res = await fetch("https://placapi.com/api/avaluo-por-codigo", {
method: "POST",
headers: {
"x-api-key": "pk_live_TU_CLAVE",
"content-type": "application/json",
},
body: JSON.stringify({"codeFasecolda":"05636023"}),
});
const data = await res.json();import requests
res = requests.post(
"https://placapi.com/api/avaluo-por-codigo",
headers={"x-api-key": "pk_live_TU_CLAVE"},
json={"codeFasecolda":"05636023"},
)
data = res.json()Respuesta exitosa
{
"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"
}
},
"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
- ¿Pide la placa del vehículo?
- No, nunca. Ni la placa ni el documento del propietario: solo el código FASECOLDA y, opcionalmente, el año del modelo. Por eso este endpoint no consulta al RUNT.
- ¿codeFasecolda y codigo son el mismo parámetro?
- Sí. codigo es el alias corto de codeFasecolda; cualquiera de los dos nombres funciona igual en el cuerpo de la solicitud, y la respuesta es idéntica.
- ¿Qué diferencia hay con /api/avaluo?
- El mismo dato, con una entrada distinta: /api/avaluo recibe placa y documento y resuelve el código internamente contra el RUNT y FASECOLDA; avaluo-por-codigo se salta ese paso porque ya se le entrega el código resuelto.
- ¿Cuesta lo mismo que /api/avaluo?
- Sí, 1 crédito por consulta que trae datos, con la misma regla de caché: un resultado servido desde caché no descuenta crédito.
¿Para qué se usa?
- Aseguradoras con el código ya guardado en su tarifario, para refrescar el valor sin volver a identificar el vehículo por placa.
- Financieras y prendarias que valoran garantías por código, comparando muchos vehículos del mismo tipo.
- Concesionarios que ya normalizaron su inventario contra el catálogo y solo necesitan el precio actualizado.
Si en cambio se parte de una placa, el punto de entrada es avalúo por placa; si se parte de cero, sin conocer la versión, es el catálogo.
Última revisión: 3 de septiembre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.