Vehicle Values by Plate - Fasecolda
Verifik's Fasecolda Vehicle Values by Plate API retrieves official commercial valuations and technical specifications for vehicles registered in Colombia using only a license plate. To maximize coverage across passenger cars, SUVs, pickups, heavy vehicles, and motorcycles, this endpoint combines two complementary official vehicle data sources:
- Primary Resolution (Direct Plate-to-Code Index): When the license plate is directly linked to a Fasecolda valuation code in the primary index, Verifik returns the exact catalog entry immediately.
- Secondary Resolution (Cross-Source Specification Matching): When a vehicle (such as most motorcycles or newly registered vehicles) is not directly indexed by plate in the valuation registry, Verifik automatically retrieves the vehicle's verified technical specifications (
brand,line,cylinderCapacity,year, andvehicleClass) from a secondary official vehicle registry and cross-matches them against the Fasecolda valuation catalog.
Whenever a response is resolved through cross-source specification matching, the payload includes full provenance and scoring metadata (matchSource, matchConfidence, matchNote, matchDetails, and runtVehicle) so your underwriting or appraisal workflow knows exactly how the valuation code was matched and why any score points were deducted.
What does this API validate?
- Vehicle Information by Plate: Supports Colombian automobile, SUV, pickup, commercial, and motorcycle license plates (
ABC123,ABC12D,ABC12). Input plates are automatically normalized (uppercased, with spaces, hyphens, and periods removed). - Comprehensive Technical & Valuation Data: Returns Fasecolda
code/homoloCode,marke(brand),line1,line2,line3,class,category,cylinderCapacity,fuel,transmission,bcpp(base commercial price), andvalueModel(historical values by model year). - Dual-Source Transparency & Confidence Breakdown: Provides a weighted confidence score (
0.60to1.00) and a transparent point-by-point explanation (matchDetails.penalties) whenever cross-source specification matching is used.
API Reference
Endpoint
GET https://api.verifik.co/v2/co/fasecolda/values-by-plate
The Fasecolda Vehicle Value Inquiry service returns official valuation and technical attributes (code, marke, line1, line2, line3, class, cylinderCapacity, bcpp, valueModel) for Colombian vehicles. When resolved via cross-source specification matching, it also returns matchSource, matchConfidence, matchNote, matchDetails, and runtVehicle. Pass the license plate as a query parameter.
Headers
| Name | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
Parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
plate | string | Yes | Colombian vehicle or motorcycle license plate. Spaces, hyphens, and periods are stripped automatically. | 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
- Dual-Source Coverage (Cars & Motorcycles): When a license plate is directly indexed in the primary valuation registry, the response returns the exact Fasecolda record (
matchSourceis omitted). When the plate is not directly indexed—which is common for motorcycles and certain light vehicles—Verifik verifies the vehicle's technical specifications from an official secondary vehicle registry and matches them against the Fasecolda valuation catalog (matchSource: "runt_fallback"). - Confidence Formula (
matchConfidence&matchDetails): Cross-source matches are scored on a0.00to1.00scale using0.55 * textScore + 0.25 * ccScore + 0.20 * yearScore. Only matches withmatchConfidence >= 0.60are returned; anything lower returns404. - Understanding What Lowers
matchConfidence(matchDetails.penalties):- Extra catalog trim/spec tokens (
textPointsout of0.55): Official vehicle registration records often store only the base model line (for example,"VERSA","TRACKER", or"TRK 502X"), whereas the Fasecolda catalog includes trim, transmission, and braking suffixes ("ADVANCE AT 1600CC 2AB ABS"or"MT 500CC ABS"). Those extra catalog tokens are listed inextraGuideTokensand explain why a 100% accurate vehicle match typically scores between0.71and0.95. - Homologation vs. commercial line codes: Some manufacturers register factory chassis codes (such as
"FZN250 A"for"FZ25 250"or"GPD150 A NMAX"for"NMAX"). Token differences are itemized inunmatchedRuntTokens. - Nominal cylinder capacity rounding (
ccPointsout of0.25): A within-5% displacement difference (such as199ccvs200ccor124ccvs125cc) receives full points (0.25/0.25); larger nominal catalog rounding (such as373ccvs400ccnominal class) deducts-0.07and is noted inpenalties.
- Extra catalog trim/spec tokens (
- Valuation Units:
valueModelcontains commercial values by model year, andbcpprepresents the base commercial price (expressed in thousands of Colombian Pesos, COP).
More information
The sections below are general product documentation (not part of the API contract).
Common Use Cases
- Motorcycle & Vehicle Valuation: Obtain reliable commercial valuations for both passenger vehicles and motorcycles using only the license plate.
- Insurance Underwriting & Quoting: Automate policy quoting with complete transparency into whether a valuation code came from a direct plate index or a verified specification cross-match.
- Collateral & Fleet Appraisal: Evaluate used vehicle portfolios and verify technical specifications (
cylinderCapacity,class,fuel,transmission) in a single request.