按车牌查询车辆价值 - Fasecolda
Verifik 的 Fasecolda 按车牌查询车辆价值 API 仅需车牌即可获取哥伦比亚注册车辆的官方商业估值与技术规格。为了在乘用车、SUV、皮卡、重型商用车和摩托车上实现最高查询成功率,此端点结合了两个互补的官方车辆数据源:
- 主要解析(车牌-代码直接索引):当车牌在主要估值索引中直接关联了 Fasecolda 估值代码时,Verifik 会立即返回目录中的精确条目。
- 次要解析(跨源技术规格匹配):当车辆(尤其是大多数摩托车或新注册车辆)未按车牌直接编入估值索引时,Verifik 会自动从官方二级车辆登记记录中获取经核实的技术规格(
brand、line、cylinderCapacity、year和vehicleClass),并与 Fasecolda 估值目录进行交叉匹配(matchSource: "runt_fallback")。
每当响应通过跨源技术规格匹配解析时,返回结果都会包含完整的溯源和评分明细(matchSource、matchConfidence、matchNote、matchDetails 和 runtVehicle),让您的核保或评估流程清楚了解估值代码是如何匹配的,以及哪些因素扣减了置信度得分。
此 API 验证哪些内容?
- 按车牌查询汽车与摩托车信息:支持哥伦比亚轿车、SUV、皮卡、商用车和摩托车车牌(
ABC123、ABC12D、ABC12)。输入的车牌会自动标准化(转为大写并去除空格、连字符和句点)。 - 完整的技术与估值数据:返回 Fasecolda 代码(
code/homoloCode)、品牌(marke)、车型系列(line1、line2、line3)、车辆类别(class)、分类(category)、排量(cylinderCapacity)、燃料(fuel)、变速箱(transmission)、基准商业价格(bcpp)以及分年份历史价格(valueModel)。 - 双源透明度与置信度评分明细:在跨源匹配时提供加权置信度得分(
0.60至1.00)以及每项扣分的详细说明(matchDetails.penalties)。
Endpoint
GET https://api.verifik.co/v2/co/fasecolda/values-by-plate
查询哥伦比亚注册车辆的官方估值与技术属性(code、marke、line1、line2、line3、class、cylinderCapacity、bcpp、valueModel),并在跨源规格匹配时返回 matchSource、matchConfidence、matchNote、matchDetails 和 runtVehicle。通过查询参数 plate 传入车牌。
Headers
| Name | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
Parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
plate | string | Yes | 哥伦比亚汽车或摩托车车牌(空格、连字符和句点会自动去除)。 | 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 (Direct Match)
- 200 (Cross-Source Match)
- 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
- 双源覆盖(汽车与摩托车):当车牌在主要估值索引中直接建有索引时,返回精确的 Fasecolda 记录(省略
matchSource)。当车牌未直接建有索引时(在摩托车及部分轻型车辆中尤为常见),Verifik 会从官方二级车辆登记记录核实技术规格并与 Fasecolda 估值目录匹配(matchSource: "runt_fallback")。 - 置信度计算公式(
matchConfidence与matchDetails):跨源匹配按0.55 * textScore + 0.25 * ccScore + 0.20 * yearScore在0.00至1.00范围内计分,最低阈值为0.60。 - 导致
matchConfidence扣分的因素(matchDetails.penalties):- 目录中额外的配置/变速箱词元(
textPoints,满分0.55):车辆登记记录通常仅保存基础车系名称(如"VERSA"、"TRACKER"或"TRK 502X"),而 Fasecolda 目录包含具体配置、变速箱和 ABS 后缀(如"ADVANCE AT 1600CC 2AB ABS")。这些额外词元列在extraGuideTokens中。 - 公告型号代码与商业名称差异:例如
"FZN250 A"对应"FZ25 250",差异词元记录在unmatchedRuntTokens中。 - 标称排量取整差异(
ccPoints,满分0.25):5% 以内的排量差异(如199cc与200cc)得满分(0.25/0.25);较大的目录标称排量差异(如373cc与400cc)扣减-0.07并在penalties中说明。
- 目录中额外的配置/变速箱词元(
- 估值单位:
valueModel为按车型年份的历史价格数组,bcpp为基准商业基础价(单位为哥伦比亚比索 COP)。