{"openapi":"3.1.0","info":{"title":"Vehicle Database API","version":"1.0.0","description":"Decode any Vehicle Identification Number (VIN) into a full, structured vehicle specification — make, manufacturer, model, year, trim, series, body class, vehicle type, drive type, doors, engine (cylinders, displacement, horsepower, configuration and primary/secondary fuel), transmission style, gross vehicle weight rating and the manufacturing plant (country, city, state, company). Partial VINs with wildcards are supported and an optional model year improves accuracy. The API also lists every vehicle make (optionally for a vehicle type such as car, truck or motorcycle) and all models for a given make and year. Backed by the official NHTSA vPIC database, with clean, predictable JSON and no raw-data wrangling. Every endpoint accepts input via the query string or the request body. Ideal for automotive marketplaces, insurance and fleet tools, dealer and parts catalogues, and vehicle-registration flows.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/vehicledb-api","description":"oanor gateway"}],"tags":[{"name":"Vehicle"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/decode":{"get":{"operationId":"get_v1_decode","tags":["Vehicle"],"summary":"Decode a VIN to vehicle specs","description":"","parameters":[{"name":"vin","in":"query","required":true,"description":"8-17 char VIN (* allowed for partial)","schema":{"type":"string"},"example":"5YJ3E1EA7KF317324"},{"name":"year","in":"query","required":false,"description":"Model year (improves partial VINs)","schema":{"type":"string"},"example":"2019"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"vin":"5YJ3E1EA7KF317324","gvwr":"Class 1: 6,000 lb or less (2,722 kg or less)","make":"TESLA","year":2019,"doors":4,"model":"Model 3","plant":{"city":"FREMONT","state":"CALIFORNIA","country":"UNITED STATES (USA)"},"engine":{"fuel_primary":"Electric"},"body_class":"Sedan/Saloon","error_code":"1","error_text":"1 - Check Digit (9th position) does not calculate properly","manufacturer":"TESLA, INC.","transmission":"Automatic","vehicle_type":"PASSENGER CAR"},"meta":{"timestamp":"2026-05-30T22:48:27.145Z","request_id":"510676c6-a0bc-46b7-a2fa-edb9b4b4d622"},"status":"ok","message":"VIN decoded","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/makes":{"get":{"operationId":"get_v1_makes","tags":["Vehicle"],"summary":"All makes (or for a vehicle type)","description":"","parameters":[{"name":"type","in":"query","required":false,"description":"car|truck|motorcycle|bus|trailer|...","schema":{"type":"string"},"example":"car"},{"name":"limit","in":"query","required":false,"description":"Max makes","schema":{"type":"string"},"example":"500"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"car","count":193,"makes":[{"id":440,"name":"ASTON MARTIN"},{"id":441,"name":"TESLA"},{"id":442,"name":"JAGUAR"},{"id":443,"name":"MASERATI"},{"id":445,"name":"ROLLS-ROYCE"},{"id":448,"name":"TOYOTA"},{"id":449,"name":"MERCEDES-BENZ"},{"id":452,"name":"BMW"},{"id":454,"name":"BUGATTI"},{"id":456,"name":"MINI"},{"id":460,"name":"FORD"},{"id":464,"name":"LINCOLN"},{"id":465,"name":"MERCURY"},{"id":466,"name":"LOTUS"},{"id":467,"name":"CHEVROLET"},{"id":468,"name":"BUICK"},{"id":469,"name":"CADILLAC"},{"id":470,"name":"HOLDEN"},{"id":471,"name":"OPEL"},{"id":472,"name":"GMC"},{"id":473,"name":"MAZDA"},{"id":474,"name":"HONDA"},{"id":475,"name":"ACURA"},{"id":476,"name":"DODGE"},{"id":477,"name":"CHRYSLER"},{"id":478,"name":"NISSAN"},{"id":480,"name":"INFINITI"},{"id":481,"name":"MITSUBISHI"},{"id":482,"name":"VOLKSWAGEN"},{"id":485,"name":"VOLVO"},{"id":492,"name":"FIAT"},{"id":493,"name":"ALFA ROMEO"},{"id":497,"name":"LANCIA"},{"id":498,"name":"HYUNDAI"},{"id":499,"name":"KIA"},{"id":502,"name":"LAMBORGHINI"},{"id":504,"name":"SMART"},{"id":509,"name":"SUZUKI"},{"id":515,"name":"LEXUS"},{"id":523,"name":"SUBARU"},{"id":533,"name":"MAYBACH"},{"id":536,"name":"PONTIAC"},{"id":542,"name":"ISUZU"},{"id":565,"name":"TRIUMPH"},{"id":572,"name":"SAAB"},{"id":582,"name":"AUDI"},{"id":583,"name":"BENTLEY"},{"id":584,"name":"PORSCHE"},{"id":603,"name":"FERRARI"},{"id":606,"name":"AM GENERAL"},{"id":629,"name":"CREATIVE COACHWORKS"},{"id":771,"name":"AC PROPULSION"},{"id":847,"name":"DAIHATSU"},{"id":972,"name":"FALCON"},{"id":986,"name":"EV INNOVATIONS"},{"id":992,"name":"FAW JIAXING HAPPY MESSENGER"},{"id":1056,"name":"SATURN"},{"id":1077,"name":"DAEWOO"},{"id":1124,"name":"AMERICAN MOTORS"},{"id":1142,"name":"FORMULA 1 STREET COM"},{"id":1146,"name":"GEO"},{"id":1151,"name":"FORTUNESPORT VES"},{"id":1288,"name":"AAS"},{"id":1292,"name":"EQUUS AUTOMOTIVE"},{"id":1393,"name":"ELECTRIC MOBILE CARS"},{"id":1498,"name":"AVERA MOTORS"},{"id":1683,"name":"BAKKURA MOBILITY"},{"id":1755,"name":"TH!NK"},{"id":1777,"name":"CODA"},{"id":1869,"name":"CONTEMPORARY CLASSIC CARS (CCC)"},{"id":1896,"name":"KOENIGSEGG"},{"id":1991,"name":"BYD"},{"id":2018,"name":"KANDI"},{"id":2049,"name":"KEPLER MOTORS"},{"id":2131,"name":"MAKING YOU MOBILE"},{"id":2236,"name":"MCLAREN"},{"id":2376,"name":"MYCAR"},{"id":2408,"name":"EAGLE"},{"id":2409,"name":"PLYMOUTH"},{"id":2665,"name":"NJD AUTOMOTIVE LLC"},{"id":2745,"name":"PHOENIX MOTORCARS"},{"id":3176,"name":"ROCKET SLED MOTORS"},{"id":3440,"name":"VISION INDUSTRIES"},{"id":3540,"name":"WARHAWK PERFORMANCE"},{"id":3583,"name":"UKEYCHEYMA"},{"id":3706,"name":"TOTAL ELECTRIC VEHICLES"},{"id":3766,"name":"SPYKER"},{"id":4162,"name":"OLDSMOBILE"},{"id":4220,"name":"PANOZ"},{"id":4355,"name":"SALEEN"},{"id":4410,"name":"SOLECTRIA"},{"id":4451,"name":"YESTER YEAR AUTO"},{"id":4596,"name":"BXR"},{"id":4634,"name":"ENGINE CONNECTION"},{"id":4644,"name":"BLUECAR"},{"id":4764,"name":"MOSLER"},{"id":4767,"name":"PAGANI"},{"id":4859,"name":"REVOLOGY"},{"id":5015,"name":"EMA"},{"id":5042,"name":"COSTIN SPORTS CAR"},{"id":5083,"name":"GENESIS"},{"id":5122,"name":"KARMA"},{"id":5208,"name":"MATRIX MOTOR COMPANY"},{"id":5367,"name":"ARMBRUSTER STAGEWAY"},{"id":5381,"name":"LUMEN"},{"id":5464,"name":"ASUNA"},{"id":5468,"name":"MERKUR"},{"id":5552,"name":"AVANTI"},{"id":5553,"name":"YUGO"},{"id":5554,"name":"PEUGEOT"},{"id":5555,"name":"STERLING MOTOR CAR"},{"id":5557,"name":"CONSULIER GTP"},{"id":5657,"name":"DATSUN"},{"id":5661,"name":"PININFARINA"},{"id":5760,"name":"VINTAGE AUTO"},{"id":5767,"name":"LONDONCOACH INC"},{"id":5848,"name":"MGS GRAND SPORT (MARDIKIAN)"},{"id":5938,"name":"PANTHER"},{"id":6018,"name":"DAYTONA COACH BUILDERS"},{"id":6069,"name":"UCC"},{"id":6263,"name":"RS SPIDER"},{"id":6264,"name":"GRUPPE B"},{"id":6265,"name":"RALLY SPORT"},{"id":6313,"name":"RENAISSANCE"},{"id":6364,"name":"JAC 427"},{"id":6408,"name":"HUNTER DESIGN GROUP, LLC"},{"id":6473,"name":"BLACKWATER"},{"id":6663,"name":"GULLWING INTERNATIONAL MOTORS, LTD."},{"id":6759,"name":"AMERITECH CORPORATION"},{"id":6792,"name":"STANFORD CUSTOMS"},{"id":6880,"name":"CLASSIC ROADSTERS"},{"id":6986,"name":"HERITAGE"},{"id":7099,"name":"COBRA CARS"},{"id":7207,"name":"C-R CHEETAH RACE CARS"},{"id":7225,"name":"PAS"},{"id":7425,"name":"BUG MOTORS"},{"id":7477,"name":"EXCALIBUR AUTOMOBILE CORPORATION"},{"id":7765,"name":"IVES MOTORS CORPORATION (IMC)"},{"id":7836,"name":"AUTODELTA USA INC"},{"id":8395,"name":"AUTOCAR LTD"},{"id":8549,"name":"MOKE"},{"id":8605,"name":"BBC"},{"id":8785,"name":"PHOENIX SPORTS CARS, INC."},{"id":9250,"name":"VECTOR AEROMOTIVE CORPORATION"},{"id":9326,"name":"CARBODIES"},{"id":9364,"name":"CREATIVE COACHWORKS INC."},{"id":9376,"name":"WESTFALL MOTORS CORP."},{"id":9401,"name":"CLENET"},{"id":9448,"name":"ELECTRIC CAR COMPANY"},{"id":9458,"name":"CX AUTOMOTIVE"},{"id":9533,"name":"LA EXOTICS"},{"id":9572,"name":"CLASSIC SPORTS CARS"},{"id":9720,"name":"SF MOTORS INC."},{"id":9759,"name":"SCUDERIA CAMERON GLICKENHAUS (SCG)"},{"id":10029,"name":"VINTAGE CRUISER"},{"id":10030,"name":"VINTAGE MICROBUS"},{"id":10031,"name":"VINTAGE ROVER"},{"id":10047,"name":"LITE CAR"},{"id":10224,"name":"POLESTAR"},{"id":10256,"name":"CZINGER"},{"id":10393,"name":"GLICKENHAUS"},{"id":10623,"name":"DONGFENG"},{"id":10647,"name":"CRUISE"},{"id":10919,"name":"LUCID"},{"id":11076,"name":"CALMOTORS"},{"id":11346,"name":"AUTOMOBILI PININFARINA"},{"id":11792,"name":"ALLARD MOTOR WORKS"},{"id":11832,"name":"SHELBY"},{"id":11856,"name":"FISKER"},{"id":11921,"name":"RIMAC"},{"id":11938,"name":"ZOOX"},{"id":12074,"name":"ECOCAR"},{"id":12400,"name":"SUPERCAR SYSTEM"},{"id":12550,"name":"RUF"},{"id":12706,"name":"KINDIG"},{"id":12771,"name":"SSC NORTH AMERICA"},{"id":12783,"name":"BALLISTIC"},{"id":12894,"name":"MEYERS MANX"},{"id":12948,"name":"1955 CUSTOM BELAIR"},{"id":12980,"name":"ELKINGTON"},{"id":12991,"name":"MK SPORTSCARS"},{"id":13018,"name":"SHAY REPRODUCTION"},{"id":13022,"name":"DELOREAN"},{"id":13024,"name":"CLENET COACHWORKS"},{"id":13025,"name":"CHECKER"},{"id":13026,"name":"BERTONE"},{"id":13028,"name":"CAMELOT"},{"id":13271,"name":"ZEEKR"},{"id":13380,"name":"BACKDRAFT"},{"id":13391,"name":"FALCON MOTORS"},{"id":13585,"name":"MAYHEM AUTOWORKZ"},{"id":13647,"name":"RENAULT"},{"id":13887,"name":"HEDLEY STUDIOS"}],"total":193},"meta":{"timestamp":"2026-05-30T22:48:27.477Z","request_id":"72ff9251-db0b-42d9-afd3-2bc58a795d30"},"status":"ok","message":"Makes retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/models":{"get":{"operationId":"get_v1_models","tags":["Vehicle"],"summary":"Models for a make","description":"","parameters":[{"name":"make","in":"query","required":true,"description":"Make name","schema":{"type":"string"},"example":"honda"},{"name":"year","in":"query","required":false,"description":"Model year","schema":{"type":"string"},"example":"2022"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"make":"honda","year":2022,"count":111,"models":[{"id":1861,"make":"HONDA","name":"Accord"},{"id":1863,"make":"HONDA","name":"Civic"},{"id":1864,"make":"HONDA","name":"Pilot"},{"id":1865,"make":"HONDA","name":"CR-V"},{"id":1866,"make":"HONDA","name":"Ridgeline"},{"id":1869,"make":"HONDA","name":"Odyssey"},{"id":1870,"make":"HONDA","name":"Insight"},{"id":3234,"make":"HONDA","name":"PCX150"},{"id":3249,"make":"HONDA","name":"Gold Wing"},{"id":3251,"make":"HONDA","name":"NC700X"},{"id":3253,"make":"HONDA","name":"NPS50 (Ruckus)"},{"id":3255,"make":"HONDA","name":"ST1300PA"},{"id":3264,"make":"HONDA","name":"ST1300"},{"id":3618,"make":"HONDA","name":"Pacific Coast"},{"id":3684,"make":"HONDA","name":"Hawk GT"},{"id":3695,"make":"HONDA","name":"CB-1"},{"id":3697,"make":"HONDA","name":"Tourist Trophy"},{"id":3698,"make":"HONDA","name":"NS50F"},{"id":3699,"make":"HONDA","name":"NX250"},{"id":3700,"make":"HONDA","name":"NX125"},{"id":3703,"make":"HONDA","name":"RC30"},{"id":3705,"make":"HONDA","name":"XL600V"},{"id":3776,"make":"HONDA","name":"Elite"},{"id":5959,"make":"HONDA","name":"Passport"},{"id":9212,"make":"HONDA","name":"HR-V"},{"id":10253,"make":"HONDA","name":"CB500"},{"id":10791,"make":"HONDA","name":"FourTrax"},{"id":10960,"make":"HONDA","name":"CR250R"},{"id":11408,"make":"HONDA","name":"CR125R"},{"id":11409,"make":"HONDA","name":"XR250R"},{"id":11588,"make":"HONDA","name":"TRX90X"},{"id":11589,"make":"HONDA","name":"XR600R"},{"id":11728,"make":"HONDA","name":"FourTrax Foreman"},{"id":11759,"make":"HONDA","name":"NCH50 (Giorno)"},{"id":11760,"make":"HONDA","name":"NCH50 (Metropolitan)"},{"id":11762,"make":"HONDA","name":"NSS300 (Forza)"},{"id":11796,"make":"HONDA","name":"MRT260/COTA 4RT260"},{"id":11803,"make":"HONDA","name":"CBR500"},{"id":11819,"make":"HONDA","name":"NC750X"},{"id":11827,"make":"HONDA","name":"CBR300"},{"id":11835,"make":"HONDA","name":"TRX250X"},{"id":11837,"make":"HONDA","name":"FourTrax Recon"},{"id":11975,"make":"HONDA","name":"CBR1000F"},{"id":12058,"make":"HONDA","name":"VT750 (Shadow Aero 750)"},{"id":12132,"make":"HONDA","name":"VT750 (Shadow Phantom 750)"},{"id":12573,"make":"HONDA","name":"CR80R"},{"id":12575,"make":"HONDA","name":"XR80R"},{"id":12651,"make":"HONDA","name":"CR500R"},{"id":12663,"make":"HONDA","name":"Z50R"},{"id":13450,"make":"HONDA","name":"Cota"},{"id":14865,"make":"HONDA","name":"CB125"},{"id":23307,"make":"HONDA","name":"NCW50 (Metropolitan)"},{"id":27408,"make":"HONDA","name":"ADV150"},{"id":27409,"make":"HONDA","name":"Fireblade"},{"id":27839,"make":"HONDA","name":"FourTrax Foreman Rubicon"},{"id":27897,"make":"HONDA","name":"SXS1000M (Pioneer 1000)"},{"id":27898,"make":"HONDA","name":"SXS700M (Pioneer 700)"},{"id":27899,"make":"HONDA","name":"SXS500M (Pioneer 500)"},{"id":27906,"make":"HONDA","name":"TRX500 (Foreman)"},{"id":27909,"make":"HONDA","name":"TRX500 (Rubicon)"},{"id":27942,"make":"HONDA","name":"Trail125"},{"id":28626,"make":"HONDA","name":"CRF300L"},{"id":28850,"make":"HONDA","name":"Monkey"},{"id":29417,"make":"HONDA","name":"Civic Si"},{"id":29509,"make":"HONDA","name":"Navi"},{"id":29619,"make":"HONDA","name":"PCX"},{"id":30374,"make":"HONDA","name":"SXS520M (Pioneer 520)"},{"id":33259,"make":"HONDA","name":"CRF230F"},{"id":33279,"make":"HONDA","name":"CRF125F"},{"id":33280,"make":"HONDA","name":"CRF125FB"},{"id":33281,"make":"HONDA","name":"CRF150F"},{"id":33282,"make":"HONDA","name":"CRF150R"},{"id":33284,"make":"HONDA","name":"CRF150RB"},{"id":33285,"make":"HONDA","name":"CRF250L"},{"id":33286,"make":"HONDA","name":"CRF250R"},{"id":33288,"make":"HONDA","name":"CRF50F"},{"id":33289,"make":"HONDA","name":"CRF110F"},{"id":33290,"make":"HONDA","name":"CRF450R"},{"id":33291,"make":"HONDA","name":"CRF450X"},{"id":33292,"make":"HONDA","name":"CRF250RX"},{"id":33293,"make":"HONDA","name":"CRF250F"},{"id":33294,"make":"HONDA","name":"CRF450RX"},{"id":33499,"make":"HONDA","name":"XR650L"},{"id":33503,"make":"HONDA","name":"CBR600RR"},{"id":33505,"make":"HONDA","name":"CBR500R"},{"id":33508,"make":"HONDA","name":"CB500F"},{"id":33510,"make":"HONDA","name":"CB500X"},{"id":33515,"make":"HONDA","name":"CBR1000RR"},{"id":33518,"make":"HONDA","name":"CB1000R"},{"id":33524,"make":"HONDA","name":"CBR300R"},{"id":33535,"make":"HONDA","name":"CB300R"},{"id":33536,"make":"HONDA","name":"CBR650R"},{"id":33537,"make":"HONDA","name":"CB650R"},{"id":35229,"make":"HONDA","name":"Africa Twin"},{"id":35230,"make":"HONDA","name":"Fury"},{"id":36707,"make":"HONDA","name":"Foreman"},{"id":36708,"make":"HONDA","name":"Rubicon"},{"id":36711,"make":"HONDA","name":"Foreman Rubicon"},{"id":36712,"make":"HONDA","name":"Rancher"},{"id":36713,"make":"HONDA","name":"Recon"},{"id":36952,"make":"HONDA","name":"Rebel 1100"},{"id":36953,"make":"HONDA","name":"Rebel 300"},{"id":36954,"make":"HONDA","name":"Rebel 500"},{"id":37126,"make":"HONDA","name":"Gold Wing Tour"},{"id":37127,"make":"HONDA","name":"Grom"},{"id":37131,"make":"HONDA","name":"Super Cub C125"},{"id":37132,"make":"HONDA","name":"Africa Twin Adventure Sports"},{"id":37133,"make":"HONDA","name":"SXS1000S (Talon 1000)"},{"id":37149,"make":"HONDA","name":"CBR600F"},{"id":37544,"make":"HONDA","name":"VTR250 (Interceptor 250)"},{"id":37555,"make":"HONDA","name":"VF750 (Interceptor 750)"}]},"meta":{"timestamp":"2026-05-30T22:48:27.816Z","request_id":"e1c2aa38-0eab-4e6b-bdb7-5cf60175ad92"},"status":"ok","message":"Models retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":40000,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":880,"monthly_call_quota":480000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2500,"monthly_call_quota":2600000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6200,"monthly_call_quota":14000000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/vehicledb-api"}