Documentation
Welcome to Vehicle Databases API's Documentation
Motorcycle Decode
GETJSON Response
Overview
API provides comprehensive and accurate data about motorcycles by vin. The API returns detailed information such as make, model, year, trim, engine type, engine displacement, fuel type, transmission, manufacturer, country of origin, and vehicle class.
COVERAGE
US, Canada, and Europe, regions from 1894 to 2025
SUPPORT
Works for 17 characters VINs
HTTP Request
Endpoint
GET https://api.vehicledatabases.com/motorcycle-decode/{vin}Example — Python / Requests
Target:
Client:
import requests
response = requests.get(
"https://api.vehicledatabases.com/motorcycle-decode/{vin}",
headers={"x-authkey": "YOUR_API_KEY"}
)
print(response.json())GET Parameters
| Parameter | Required | Description |
|---|---|---|
| vin | ✓ | 17 characters VIN number |
JSON Response
The response is a JSON of all the information associated with a VIN number. Each vin number has the following elements:
Response Fields
| Parameter | Description |
|---|---|
| status | "success" or "error" |
| data | An object containing all data available. |
Example Response
{
"status": "success",
"data": {
"year": 2022,
"make": "Kawasaki",
"model": "KLR 650",
"trim": "Base",
"price": {
"base_msrp": 7435,
"delivery_charges": "",
"currency": "USD"
},
"vehicle": {
"class": "",
"category": "Super motard"
},
"dimensions": [
{
"section": "Exterior",
"measurements": [
{
"name": "Length",
"values": [
{
"value": 89.8,
"unit": "in"
},
{
"value": 2280.92,
"unit": "mm"
},
{
"value": 7.48,
"unit": "ft"
}
]
},
{
"name": "Width",
"values": [
{
"value": 38.2,
"unit": "in"
},
{
"value": 970.28,
"unit": "mm"
},
{
"value": 3.18,
"unit": "ft"
}
]
},
{
"name": "Height",
"values": [
{
"value": 57.7,
"unit": "in"
},
{
"value": 1465.58,
"unit": "mm"
},
{
"value": 4.81,
"unit": "ft"
}
]
},
{
"name": "Wheelbase",
"values": [
{
"value": 58.3,
"unit": "in"
},
{
"value": 1480.82,
"unit": "mm"
},
{
"value": 4.86,
"unit": "ft"
}
]
},
{
"name": "Ground Clearance",
"values": [
{
"value": 8.3,
"unit": "in"
},
{
"value": 210.82,
"unit": "mm"
},
{
"value": 0.69,
"unit": "ft"
}
]
},
{
"name": "Trail",
"values": [
{
"value": 4.8,
"unit": "in"
},
{
"value": 122,
"unit": "mm"
}
]
}
]
},
{
"section": "Weights",
"measurements": [
{
"name": "Wet Weight",
"values": [
{
"value": "",
"unit": "lbs"
},
{
"value": "",
"unit": "Kgs"
}
]
},
{
"name": "Dry Weight",
"values": [
{
"value": "",
"unit": "lbs"
},
{
"value": "",
"unit": "Kgs"
}
]
},
{
"name": "Payload Capacity",
"values": [
{
"value": "",
"unit": "lbs"
},
{
"value": "",
"unit": "Kgs"
}
]
},
{
"name": "Gross Vechile Weight Rating",
"values": [
{
"value": "",
"unit": "lbs"
},
{
"value": "",
"unit": "Kgs"
}
]
},
{
"name": "Towing Capacity",
"values": [
{
"value": "",
"unit": "lbs"
},
{
"value": "",
"unit": "Kgs"
}
]
},
{
"name": "Total Weight",
"values": [
{
"value": 456.2,
"unit": "lbs"
},
{
"value": 206.89,
"unit": "Kgs"
}
]
},
{
"name": "Power Weigt Ratio",
"values": [
{
"value": "",
"unit": "HP/Kg"
}
]
}
]
},
{
"section": "Suspension",
"measurements": [
{
"name": "Front Suspension Size",
"values": [
{
"value": "",
"unit": "in"
},
{
"value": "",
"unit": "mm"
}
]
},
{
"name": "Rear Suspension Size",
"values": [
{
"value": "",
"unit": "in"
},
{
"value": "",
"unit": "mm"
}
]
},
{
"name": "Front Travel",
"values": [
{
"value": "",
"unit": "in"
},
{
"value": "",
"unit": "mm"
}
]
},
{
"name": "Rear Travel",
"values": [
{
"value": "",
"unit": "in"
},
{
"value": "",
"unit": "mm"
}
]
},
{
"name": "Fork Rake Angle",
"values": [
{
"value": 30,
"unit": "Degree"
}
]
}
]
},
{
"section": "Braking",
"measurements": [
{
"name": "Front Brake Diameter",
"values": [
{
"value": 9.4,
"unit": "in"
},
{
"value": 240,
"unit": "mm"
}
]
},
{
"name": "Rear Brake Diameter",
"values": [
{
"value": 9.4,
"unit": "in"
},
{
"value": 240,
"unit": "mm"
}
]
}
]
},
{
"section": "Seating",
"measurements": [
{
"name": "Seat Height",
"values": [
{
"value": 34.3,
"unit": "in"
},
{
"value": 871.22,
"unit": "mm"
}
]
},
{
"name": "Alternate Seat Height",
"values": [
{
"value": "",
"unit": "in"
},
{
"value": "",
"unit": "mm"
}
]
}
]
},
{
"section": "Wheels",
"measurements": [
{
"name": "Front Wheel Diameter",
"values": [
{
"value": "",
"unit": "in"
}
]
},
{
"name": "Front Wheel Diamter",
"values": [
{
"value": "",
"unit": "mm"
}
]
},
{
"name": "Rear Wheel Diamter",
"values": [
{
"value": "",
"unit": "in"
},
{
"value": "",
"unit": "mm"
}
]
},
{
"name": "Front Wheel Width",
"values": [
{
"value": 7.9,
"unit": "in"
},
{
"value": 200.66,
"unit": "mm"
}
]
},
{
"name": "Rear Wheel Width",
"values": [
{
"value": 7.3,
"unit": "in"
},
{
"value": 185.42,
"unit": "mm"
}
]
}
]
},
{
"section": "Tires",
"measurements": [
{
"name": "Front Tire Width",
"values": [
{
"value": "",
"unit": "mm"
},
{
"value": "",
"unit": "in"
}
]
},
{
"name": "Rear Tire Width",
"values": [
{
"value": "",
"unit": "mm"
},
{
"value": "",
"unit": "in"
}
]
},
{
"name": "Front Tire Pressure",
"values": [
{
"value": 22,
"unit": "PSI"
},
{
"value": 1.5,
"unit": "Bar"
},
{
"value": 150,
"unit": "kPa"
}
]
},
{
"name": "Rear Tire Pressure",
"values": [
{
"value": 29,
"unit": "PSI"
},
{
"value": 2,
"unit": "Bar"
},
{
"value": 200,
"unit": "kPa"
}
]
},
{
"name": "Fork Tube",
"values": [
{
"value": 1.5,
"unit": "in"
},
{
"value": 38,
"unit": "mm"
}
]
}
]
},
{
"section": "Engine",
"measurements": [
{
"name": "Displacement",
"values": [
{
"value": 651,
"unit": "cc"
},
{
"value": 39.73,
"unit": "ci"
},
{
"value": 0.65,
"unit": "L"
}
]
},
{
"name": "Horsepower",
"values": [
{
"value": "",
"unit": "kW"
},
{
"value": "",
"unit": "bhp"
},
{
"value": "",
"unit": "rpm"
}
]
},
{
"name": "Torque",
"values": [
{
"value": 71.86,
"unit": "ft.lbs"
},
{
"value": 53,
"unit": "Nm"
}
]
},
{
"name": "Maximum Range",
"values": [
{
"value": "",
"unit": "mi"
},
{
"value": "",
"unit": "Km"
}
]
},
{
"name": "Carburetor Size",
"values": [
{
"value": "",
"unit": "in"
},
{
"value": "",
"unit": "mm"
}
]
},
{
"name": "Bore",
"values": [
{
"value": 3.9,
"unit": "in"
},
{
"value": 99.06,
"unit": "mm"
}
]
},
{
"name": "Stroke",
"values": [
{
"value": 3.3,
"unit": "in"
},
{
"value": 83.82,
"unit": "mm"
}
]
},
{
"name": "Fuel Injector",
"values": [
{
"value": "",
"unit": "in"
},
{
"value": "",
"unit": "mm"
}
]
},
{
"name": "Engine Displacement To Weight",
"values": [
{
"value": "",
"unit": "cc"
},
{
"value": "",
"unit": "ci"
}
]
},
{
"name": "Top Speed",
"values": [
{
"value": "",
"unit": "Km/h"
},
{
"value": "",
"unit": "mph"
}
]
},
{
"name": "Acceleration",
"values": [
{
"value": "",
"unit": "sec"
}
]
},
{
"name": "Green House",
"values": [
{
"value": "",
"unit": "g/Km"
}
]
},
{
"name": "Idle Speed",
"values": [
{
"value": 1300,
"unit": "RPM"
}
]
}
]
},
{
"section": "Fuel",
"measurements": [
{
"name": "Tank Capacity",
"values": [
{
"value": 6.1,
"unit": "gal"
},
{
"value": 23.09,
"unit": "L"
}
]
},
{
"name": "Reserve Tank Capacity",
"values": [
{
"value": "",
"unit": "gal"
},
{
"value": "",
"unit": "L"
}
]
},
{
"name": "Storage Capacity",
"values": [
{
"value": "",
"unit": "gal"
},
{
"value": "",
"unit": "L"
}
]
},
{
"name": "Oil Capacity",
"values": [
{
"value": 0.66,
"unit": "gal"
},
{
"value": 2.5,
"unit": "L"
}
]
}
]
},
{
"section": "Mileage",
"measurements": [
{
"name": "EPA City",
"values": [
{
"value": "",
"unit": "mpg"
},
{
"value": "",
"unit": "L/Km"
}
]
},
{
"name": "EPA Highway",
"values": [
{
"value": "",
"unit": "mpg"
},
{
"value": "",
"unit": "L/Km"
}
]
},
{
"name": "EPA Combined",
"values": [
{
"value": "",
"unit": "mpg"
},
{
"value": "",
"unit": "L/Km"
}
]
}
]
}
],
"specifications": [
{
"section": "Exterior",
"items": [
{
"name": "Frame Type",
"value": [
"Tubular, Semi-Double Cradle"
]
},
{
"name": "Light",
"value": [
""
]
}
]
},
{
"section": "Suspension",
"items": [
{
"name": "Front Suspension Type",
"value": [
"41mm telescopic fork"
]
},
{
"name": "Rear Suspension Type",
"value": [
"Uni-Trak single-shock system with 5-way preload and stepless rebound damping"
]
},
{
"name": "Front Suspension Brand",
"value": [
""
]
},
{
"name": "Rear Suspension Brand",
"value": [
""
]
},
{
"name": "Front Suspension Material",
"value": [
""
]
},
{
"name": "Rear Suspension Material",
"value": [
""
]
},
{
"name": "Front Adjustable Rebound Damping",
"value": [
""
]
},
{
"name": "Rear Adjustable Rebound Damping",
"value": [
""
]
},
{
"name": "Front Central Suspension Strut",
"value": [
""
]
},
{
"name": "Adjustable Front Suspension",
"value": [
""
]
},
{
"name": "Adjustable Rear Suspension",
"value": [
""
]
},
{
"name": "Steering Damper",
"value": [
""
]
},
{
"name": "Rear Shock Absorbers",
"value": [
""
]
},
{
"name": "Air Adjustable",
"value": [
""
]
}
]
},
{
"section": "Braking",
"items": [
{
"name": "Brake Type",
"value": [
""
]
},
{
"name": "Brake Brand Name",
"value": [
""
]
},
{
"name": "Front Brake Type",
"value": [
"Single disc. Two-piston calipers. Optional ABS."
]
},
{
"name": "Rear Brake Type",
"value": [
"Single disc. Single piston. Optional ABS.."
]
},
{
"name": "Abs System",
"value": [
""
]
},
{
"name": "Regenerative Breaking",
"value": [
""
]
},
{
"name": "Regenerative Deceleration",
"value": [
""
]
},
{
"name": "Linked Brake System Front To Rear",
"value": [
""
]
},
{
"name": "Brake Fluid",
"value": [
"DOT 4"
]
}
]
},
{
"section": "Seating",
"items": [
{
"name": "Seat Type",
"value": [
""
]
},
{
"name": "Seat Location",
"value": [
""
]
},
{
"name": "Seat Material",
"value": [
""
]
},
{
"name": "Grab Rail Or Strap",
"value": [
""
]
},
{
"name": "Backrest Logo Plate",
"value": [
""
]
},
{
"name": "Backrest Type",
"value": [
""
]
},
{
"name": "Backrest Location",
"value": [
""
]
},
{
"name": "Folding",
"value": [
""
]
},
{
"name": "Detachable Passenger Seat",
"value": [
""
]
},
{
"name": "Seat Tail Cover",
"value": [
""
]
},
{
"name": "Adjustable",
"value": [
""
]
},
{
"name": "Seat Backrest",
"value": [
""
]
},
{
"name": "Heated Seat",
"value": [
""
]
},
{
"name": "Lumbar Adjustment",
"value": [
""
]
},
{
"name": "Seat Rail",
"value": [
""
]
},
{
"name": "Detachable",
"value": [
""
]
},
{
"name": "Sidecar",
"value": [
""
]
},
{
"name": "Number Of Seats",
"value": [
""
]
}
]
},
{
"section": "Wheels",
"items": [
{
"name": "Wheel Type",
"value": [
""
]
},
{
"name": "Wheels Composition",
"value": [
""
]
},
{
"name": "Chromed",
"value": [
""
]
}
]
},
{
"section": "Tires",
"items": [
{
"name": "Tires Type",
"value": [
""
]
},
{
"name": "Tires Brand",
"value": [
""
]
},
{
"name": "Spare Tire",
"value": [
""
]
},
{
"name": "Front Tire Size",
"value": [
"90/90-21"
]
},
{
"name": "Rear Tire Size",
"value": [
"130/80-17"
]
},
{
"name": "Front Tire Speed Rating",
"value": [
""
]
},
{
"name": "Rear Tire Speed Rating",
"value": [
""
]
},
{
"name": "Front Tire Aspect Ratio",
"value": [
""
]
},
{
"name": "Rear Tire Aspect Ratio",
"value": [
""
]
}
]
},
{
"section": "Engine",
"items": [
{
"name": "Engine Type",
"value": [
"Single cylinder, four-stroke"
]
},
{
"name": "Engine Brand",
"value": [
""
]
},
{
"name": "Carburetor",
"value": [
""
]
},
{
"name": "Carburetion",
"value": [
""
]
},
{
"name": "Carburetion Type",
"value": [
""
]
},
{
"name": "Carburetion Brand",
"value": [
""
]
},
{
"name": "Speed Governor",
"value": [
""
]
},
{
"name": "Engine Stroke",
"value": [
""
]
},
{
"name": "Cooling",
"value": [
"Liquid"
]
},
{
"name": "Turbocharged",
"value": [
""
]
},
{
"name": "Fuel Injector",
"value": [
""
]
},
{
"name": "Primary Compression Ratio",
"value": [
"9.8:1"
]
},
{
"name": "Secondary Compression Ratio",
"value": [
""
]
},
{
"name": "Valve Configuration",
"value": [
""
]
},
{
"name": "Number Of Carburetors",
"value": [
""
]
},
{
"name": "Cylinders",
"value": [
""
]
},
{
"name": "Valves",
"value": [
""
]
},
{
"name": "Valves Per Cylinder",
"value": [
""
]
},
{
"name": "Lubrication System",
"value": [
""
]
},
{
"name": "Exhaust System",
"value": [
""
]
},
{
"name": "Emission Details",
"value": [
""
]
},
{
"name": "Ignition",
"value": [
"Electric CDI"
]
},
{
"name": "Clutch",
"value": [
"Wet multi-disc manual clutch"
]
},
{
"name": "Starter",
"value": [
"Electric"
]
},
{
"name": "Electrical",
"value": [
""
]
},
{
"name": "Engine Oil",
"value": [
"SAE 10W-40"
]
},
{
"name": "Spark Plugs",
"value": [
"NGK DPR8EA-9, NGK DPR8EIX-9"
]
}
]
},
{
"section": "Transmission",
"items": [
{
"name": "Transmission Type",
"value": [
"Chain (final drive)"
]
},
{
"name": "Transmission Brand",
"value": [
""
]
},
{
"name": "Engine Transmission Drive",
"value": [
""
]
},
{
"name": "Primary Drive Rear Wheel",
"value": [
"Sealed chain"
]
},
{
"name": "Adjustable Throttle",
"value": [
""
]
},
{
"name": "Secondary Transmission",
"value": [
""
]
},
{
"name": "Overdrive",
"value": [
""
]
},
{
"name": "Heel Toe Shifter",
"value": [
""
]
},
{
"name": "Reverse",
"value": [
""
]
},
{
"name": "Number Of Speeds",
"value": [
5
]
},
{
"name": "First Gear Ratio",
"value": [
""
]
},
{
"name": "Second Gear Ratio",
"value": [
""
]
},
{
"name": "Third Gear Ratio",
"value": [
""
]
},
{
"name": "Fourth Gear Ratio",
"value": [
""
]
},
{
"name": "Fifth Gear Ratio",
"value": [
""
]
},
{
"name": "Sixth Gear Ratio",
"value": [
""
]
},
{
"name": "Final Drive Axle Ratio",
"value": [
""
]
}
]
},
{
"section": "Fuel",
"items": [
{
"name": "Fuel Type",
"value": [
"Injection. DFI w/40mm Throttle Body"
]
},
{
"name": "Fuel Grade",
"value": [
""
]
},
{
"name": "Fuel Control",
"value": [
"Double Overhead Cams/Twin Cam (DOHC)"
]
},
{
"name": "Carrying Capacity",
"value": [
""
]
}
]
}
],
"colors": "Pearl Sand Khaki, Pearl Lava Orange",
"features": [
{
"title": "Exterior Features",
"description": []
},
{
"title": "Steering Features",
"description": []
},
{
"title": "Instrumentation Features",
"description": []
},
{
"title": "Storage Features",
"description": []
},
{
"title": "Lights Features",
"description": []
},
{
"title": "Glass Features",
"description": []
},
{
"title": "Convenience Features",
"description": []
},
{
"title": "Entertainment Features",
"description": []
},
{
"title": "Mounts Features",
"description": []
},
{
"title": "Paint And Finish Features",
"description": []
},
{
"title": "Electric Engine Features",
"description": []
}
],
"warranties": [
{
"title": "Basic",
"values": [
{
"title": "Months",
"value": 12
},
{
"title": "Miles",
"value": ""
},
{
"title": "Condition",
"value": ""
}
]
},
{
"title": "Charging System",
"values": {
"title": "Months",
"value": ""
}
},
{
"title": "Battery",
"values": {
"title": "Months",
"value": ""
}
}
]
}
}Error Responses
error
statusWhen an error occurs, the API returns an error status with a code and message.
| Code | Description | Resolution |
|---|---|---|
| 400 | Record(s) were not found for this vehicle. | Verify the VIN or YMMT is correct. |
| 401 | Invalid API Key | Check your API key for correctness and ensure it is properly formatted. |
| 403 | Rate limit exceeded | You have exceeded the number of allowed requests in a given time period. Please wait and try again. |
| 422 | Validation error | One or more parameters are invalid. Check the request parameters for correctness. |
| 500 | Internal server error | An unexpected error occurred on the server. Please try again later or contact support. |