ナンバープレートによる車両価格照会 - Fasecolda
Verifik の Fasecolda ナンバー別車両価格 API は、ナンバープレートのみでコロンビア登録車両の公式商業評価額および技術仕様を取得します。乗用車、SUV、ピックアップ、商用車、オートバイ全体で高い照会成功率を実現するため、このエンドポイントは 2つの補完的な公式車両データソースを連携させています:
- 一次解決(ナンバー・コード直接インデックス):ナンバープレートが主要評価インデックスで Fasecolda コードに直接紐付いている場合、カタログの正確なエントリを即座に返します。
- 二次解決(複数ソース間の技術仕様クロスマッチング):オートバイや新規登録車両など、ナンバーに直接コードが紐付いていない場合、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は省略)、未登録の場合(オートバイや一部の軽車両で一般的)は公式の二次車両登録データから仕様を検証して 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"や"TRK 502X"など)のみが記載される一方、Fasecolda カタログにはグレードや変速機・ABS("ADVANCE AT 1600CC 2AB ABS")が含まれます。これらの追加トークンはextraGuideTokensに記載されます。 - 型式認定コードと商用名の違い:
"FZN250 A"(商用名"FZ25 250")などの差異はunmatchedRuntTokensに記録されます。 - 排気量の公称丸め差(
ccPoints/ 最大0.25):5% 以内の差(199ccvs200cc)は満点(0.25/0.25)となり、より大きい公称差(373ccvs400cc)は-0.07減点としてpenaltiesに明記されます。
- カタログ側の追加グレード・仕様トークン(
- 通貨単位:
valueModelはモデル年別の履歴価格配列であり、bcppはコロンビアペソ(COP)建ての基準商業価格です。