Valores de Veículos por Placa - Fasecolda
A API de Valores de Veículos por Placa Fasecolda da Verifik recupera avaliações comerciais oficiais e especificações técnicas de veículos registrados na Colômbia usando apenas a placa. Para maximizar a taxa de sucesso em automóveis, SUVs, picapes, veículos pesados e motocicletas, este endpoint conecta duas fontes oficiais complementares de dados veiculares:
- Resolução Primária (Índice Direto Placa-Código): Quando a placa possui um código Fasecolda diretamente vinculado no índice principal, a Verifik retorna imediatamente a referência exata do catálogo.
- Resolução Secundária (Cruzamento de Especificações Técnicas entre Fontes): Quando um veículo (especialmente motocicletas ou veículos recém-registrados) não possui código direto indexado pela placa, a Verifik consulta automaticamente as especificações técnicas verificadas do veículo (
brand,line,cylinderCapacity,yearevehicleClass) em um registro oficial secundário e realiza o cruzamento com o catálogo de avaliação Fasecolda (matchSource: "runt_fallback").
Sempre que uma resposta é resolvida por cruzamento entre fontes, o payload inclui metadados completos de rastreabilidade e pontuação (matchSource, matchConfidence, matchNote, matchDetails e runtVehicle), explicando exatamente como o código foi obtido e o que reduziu a pontuação de confiança.
O que esta API valida?
- Informações de Veículos e Motocicletas por Placa: Suporta placas colombianas de automóveis, SUVs, picapes, caminhões e motocicletas (
ABC123,ABC12D,ABC12). A placa é normalizada automaticamente (convertida para maiúsculas e sem espaços, hífens ou pontos). - Dados Técnicos e de Avaliação Completos: Retorna código Fasecolda (
code/homoloCode), marca (marke), linhas (line1,line2,line3), classe (class), categoria (category), cilindrada (cylinderCapacity), combustível (fuel), transmissão (transmission), preço comercial base (bcpp) e histórico por ano de modelo (valueModel). - Transparência Multi-Fonte e Detalhamento de Confiança: Fornece uma pontuação ponderada (
0.60a1.00) e a explicação detalhada de cada dedução (matchDetails.penalties) quando o cruzamento de especificações é utilizado.
Endpoint
GET https://api.verifik.co/v2/co/fasecolda/values-by-plate
O serviço de consulta Fasecolda retorna os atributos técnicos e comerciais oficiais (code, marke, line1, line2, line3, class, cylinderCapacity, bcpp, valueModel) de veículos registrados na Colômbia, além de matchSource, matchConfidence, matchNote, matchDetails e runtVehicle quando resolvido por cruzamento entre fontes. Envie a placa como plate na query.
Headers
| Name | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
Parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
plate | string | Yes | Placa colombiana de veículo ou motocicleta. Espaços, hífens e pontos são removidos automaticamente. | ABC123 |
Request
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/fasecolda/values-by-plate", {
params: { plate: "ABC123" },
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/co/fasecolda/values-by-plate"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"plate": "ABC123"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
Response
- 200 (Correspondência Direta)
- 200 (Cruzamento entre Fontes)
- 404
- 422
- 409
{
"data": {
"absShow": "NO",
"airbags": "0",
"airconditioningShow": "SI",
"axles": "2",
"bcpp": "64200",
"brakes": "DISCO/TAMBOR",
"capacityLoad": "0",
"capacityPassengers": "5",
"category": "LIVIANO PASAJEROS",
"class": "AUTOMOVIL",
"code": "08001151",
"country": "COL",
"cylinderCapacity": "1598",
"doors": "5",
"electricChairs": "0",
"electricGlasses": "0",
"electricMirrors": "0",
"explorersShow": "NO",
"foodSystem": "NO APLICA",
"fuel": "GASOLINA",
"groupUpdate": "1",
"homoloCode": "08001151",
"importedShow": "NO",
"line1": "SANDERO [FL]",
"line2": "AUTHENTIQUE",
"line3": "MT 1600CC 8V AA",
"long": "4057",
"marke": "RENAULT",
"novelty": "A",
"observation": "",
"plate": "ABC123",
"power": "90",
"rearSuspension": "NO APLICA",
"reverseCameraShow": "NO",
"segmentCylinder": "L",
"segmentSize": "B",
"sensorsShow": "NO",
"service": "PARTICULAR",
"sunroofShow": "NO",
"tachometer": "NO APLICA",
"traction": "DELANTERA",
"transmission": "4X2",
"typeAddress": "HIDRÁULICA",
"typeAirConditioning": "MANUAL",
"typeBox": "MECANICA",
"typeHeadlights": "HALOGENO",
"typology": "HATCHBACK",
"upholsteryLeatherShow": "NO",
"valueModel": [
{
"modelo": "2016",
"valor": 34500,
"estado": "USADO",
"modeloId": 47,
"idEstado": 1
},
{
"modelo": "2015",
"valor": 32800,
"estado": "USADO",
"modeloId": 46,
"idEstado": 1
}
],
"weight": "1108",
"year": "2016"
},
"signature": {
"message": "Certified by Verifik.co",
"dateTime": "October 20, 2026 2:20 PM"
},
"id": "mhlt7"
}
{
"data": {
"absShow": "SI",
"airbags": "2",
"airconditioningShow": "SI",
"axles": "2",
"bcpp": "91500",
"brakes": "DISCO/TAMBOR",
"capacityLoad": "0",
"capacityPassengers": "5",
"category": "LIVIANOS PASAJEROS",
"class": "AUTOMOVIL",
"code": "06433106",
"country": "MEXICO",
"cylinderCapacity": "1598",
"doors": "4",
"electricChairs": "0",
"electricGlasses": "4",
"electricMirrors": "2",
"explorersShow": "SI",
"foodSystem": "INYECCION ELECTRONICA",
"fuel": "GASOLINA",
"groupUpdate": "L",
"homoloCode": "06433106",
"importedShow": "SI",
"line1": "VERSA [FL]",
"line2": "ADVANCE",
"line3": "AT 1600CC 2AB ABS",
"long": "4492",
"marke": "NISSAN",
"matchConfidence": "0.76",
"matchDetails": {
"ccPoints": "0.25/0.25",
"ccScore": "1",
"extraGuideTokens": [
"ADVANCE",
"AT",
"1600",
"2",
"AB",
"ABS"
],
"formula": "0.55 * textScore + 0.25 * ccScore + 0.20 * yearScore",
"guideReferenceTokens": [
"VERSA",
"ADVANCE",
"AT",
"1600",
"2",
"AB",
"ABS"
],
"matchedTokens": [
"VERSA"
],
"penalties": [
"-0.24 on line/trim text: registered vehicle line \"VERSA\" matched (VERSA), while the valuation catalog reference includes additional trim/spec tokens (ADVANCE, AT, 1600, 2, AB, ABS) not specified in the base vehicle record."
],
"runtLineTokens": [
"VERSA"
],
"textPoints": "0.31/0.55",
"textScore": "0.57",
"unmatchedRuntTokens": [],
"yearPoints": "0.20/0.20",
"yearScore": "1"
},
"matchNote": "Cross-source specification match: brand, line, cylinder capacity, model year, and vehicle class were verified from official vehicle records and matched to the closest Fasecolda valuation catalog reference. Score 0.76/1.00 (-0.24 on line/trim text: registered vehicle line \"VERSA\" matched (VERSA), while the valuation catalog reference includes additional trim/spec tokens (ADVANCE, AT, 1600, 2, AB, ABS) not specified in the base vehicle record.)",
"matchSource": "runt_fallback",
"novelty": "M",
"observation": "Ninguna",
"plate": "ABC123",
"power": "106",
"rearSuspension": "EJE RIGIDO",
"reverseCameraShow": "SI",
"runtVehicle": {
"brand": "NISSAN",
"cylinderCapacity": "1598",
"line": "VERSA",
"vehicleClass": "AUTOMOVIL",
"year": "2016"
},
"segmentCylinder": "1500 A 2000 CC",
"segmentSize": "MEDIANO",
"sensorsShow": "SI",
"service": "PARTICULAR",
"sunroofShow": "NO",
"tachometer": "SI",
"traction": "DELANTERA",
"transmission": "4X2",
"typeAddress": "ELECTRICA",
"typeAirConditioning": "MANUAL",
"typeBox": "AUTOMATICA",
"typeHeadlights": "HALOGENO",
"typology": "SEDAN",
"upholsteryLeatherShow": "NO",
"valueModel": [
{
"id": "891204",
"modelo": "2016",
"valor": "43800"
}
],
"weight": "1077",
"year": "2016"
},
"signature": {
"message": "Certified by Verifik.co",
"dateTime": "October 20, 2026 2:20 PM"
},
"id": "k9p2x"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "UnprocessableEntity",
"message": "invalid_plate_format"
}
{
"code": "MissingParameter",
"message": "missing plate"
}
Notes
- Cobertura de Dupla Fonte (Carros e Motos): Quando a placa está indexada diretamente no registro primário de avaliação, a resposta retorna o registro exato Fasecolda (
matchSourceé omitido). Quando não está indexada diretamente, a Verifik verifica as especificações técnicas em um registro oficial secundário e as cruza com o catálogo Fasecolda (matchSource: "runt_fallback"). - Fórmula de Confiança (
matchConfidenceematchDetails): Calculada de0.00a1.00pela fórmula0.55 * textScore + 0.25 * ccScore + 0.20 * yearScore(limite mínimo0.60). - O que reduz
matchConfidence(matchDetails.penalties):- Tokens adicionais de versão/equipamento no catálogo (
textPointsde0.55): Registros de matrícula costumam conter apenas a linha base (ex.:"VERSA","TRACKER"ou"TRK 502X"), enquanto o catálogo Fasecolda especifica versão, câmbio e freios ("ADVANCE AT 1600CC 2AB ABS"). Esses tokens extras aparecem emextraGuideTokens. - Códigos de homologação vs. nome comercial: Diferenças de prefixo de homologação (como
"FZN250 A"para"FZ25 250") são listadas emunmatchedRuntTokens. - Arredondamento nominal de cilindrada (
ccPointsde0.25): Diferenças até 5% (199ccvs200cc) recebem pontuação máxima (0.25/0.25); arredondamentos nominais maiores (373ccvs400cc) deduzem-0.07.
- Tokens adicionais de versão/equipamento no catálogo (
- Unidades de Avaliação:
valueModeltraz os valores históricos por ano de modelo ebcppindica o preço comercial base em Pesos Colombianos (COP).