{"openapi":"3.1.0","info":{"title":"Cars / VIN API","version":"1.0.0","description":"Decode any Vehicle Identification Number (VIN) into make, model, year, body class, engine, fuel type, drivetrain and plant — and browse vehicle makes and models by type and year. Powered by the official NHTSA vPIC database.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/cars-api","description":"oanor gateway"}],"tags":[{"name":"Vehicles"}],"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":["Vehicles"],"summary":"Decode a VIN","description":"","parameters":[{"name":"vin","in":"query","required":true,"description":"Vehicle Identification Number (* allowed for partial)","schema":{"type":"string"},"example":"5UXWX7C5*BA"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"vin":"5UXWX7C5*BA","gvwr":"Class 1D: 5,001 - 6,000 lb (2,268 - 2,722 kg)","make":"BMW","trim":"xDrive35i","doors":"4","model":"X3","engine_hp":"300","fuel_type":"Gasoline","body_class":"Sport Utility Vehicle (SUV)/Multi-Purpose Vehicle (MPV)","drive_type":"AWD/All-Wheel Drive","error_code":"6","error_text":"6 - Incomplete VIN","model_year":"2011","plant_city":"MUNICH","vehicle_type":"MULTIPURPOSE PASSENGER VEHICLE (MPV)","plant_country":"GERMANY","displacement_l":"3.0","engine_cylinders":"6"},"meta":{"timestamp":"2026-05-29T23:29:01.654Z","request_id":"50ff297a-24b9-456b-b037-c766f864df98"},"status":"ok","message":"VIN decoded successfully","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":["Vehicles"],"summary":"Makes for a vehicle type","description":"","parameters":[{"name":"type","in":"query","required":false,"description":"Vehicle type (car, truck, motorcycle, …)","schema":{"type":"string"},"example":"car"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"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"}],"vehicle_type":"car"},"meta":{"timestamp":"2026-05-29T23:29:02.749Z","request_id":"802c080a-6278-4b7c-a311-77e2304acadc"},"status":"ok","message":"Makes retrieved successfully","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":["Vehicles"],"summary":"Models for a make","description":"","parameters":[{"name":"make","in":"query","required":true,"description":"Vehicle make","schema":{"type":"string"},"example":"Honda"},{"name":"year","in":"query","required":false,"description":"4-digit model year","schema":{"type":"string"},"example":"2020"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"make":"Honda","year":"2020","count":103,"models":[{"id":1861,"name":"Accord"},{"id":1863,"name":"Civic"},{"id":1864,"name":"Pilot"},{"id":1865,"name":"CR-V"},{"id":1866,"name":"Ridgeline"},{"id":1869,"name":"Odyssey"},{"id":1870,"name":"Insight"},{"id":2127,"name":"Fit"},{"id":3249,"name":"Gold Wing"},{"id":3251,"name":"NC700X"},{"id":3253,"name":"NPS50 (Ruckus)"},{"id":3264,"name":"ST1300"},{"id":3618,"name":"Pacific Coast"},{"id":3684,"name":"Hawk GT"},{"id":3695,"name":"CB-1"},{"id":3697,"name":"Tourist Trophy"},{"id":3698,"name":"NS50F"},{"id":3699,"name":"NX250"},{"id":3700,"name":"NX125"},{"id":3703,"name":"RC30"},{"id":3705,"name":"XL600V"},{"id":3776,"name":"Elite"},{"id":5959,"name":"Passport"},{"id":9212,"name":"HR-V"},{"id":10960,"name":"CR250R"},{"id":11408,"name":"CR125R"},{"id":11409,"name":"XR250R"},{"id":11588,"name":"TRX90X"},{"id":11589,"name":"XR600R"},{"id":11658,"name":"NC700JD (NM4)"},{"id":11689,"name":"FourTrax Rancher"},{"id":11718,"name":"TRX420"},{"id":11728,"name":"FourTrax Foreman"},{"id":11756,"name":"FourTrax Rincon"},{"id":11762,"name":"NSS300 (Forza)"},{"id":11819,"name":"NC750X"},{"id":11835,"name":"TRX250X"},{"id":11837,"name":"FourTrax Recon"},{"id":11975,"name":"CBR1000F"},{"id":12058,"name":"VT750 (Shadow Aero 750)"},{"id":12132,"name":"VT750 (Shadow Phantom 750)"},{"id":12573,"name":"CR80R"},{"id":12575,"name":"XR80R"},{"id":12651,"name":"CR500R"},{"id":12663,"name":"Z50R"},{"id":14249,"name":"Clarity"},{"id":14865,"name":"CB125"},{"id":23307,"name":"NCW50 (Metropolitan)"},{"id":27839,"name":"FourTrax Foreman Rubicon"},{"id":27897,"name":"SXS1000M (Pioneer 1000)"},{"id":27898,"name":"SXS700M (Pioneer 700)"},{"id":27899,"name":"SXS500M (Pioneer 500)"},{"id":28850,"name":"Monkey"},{"id":29619,"name":"PCX"},{"id":31535,"name":"Civic Type R"},{"id":33193,"name":"NCW50 (Giorno)"},{"id":33259,"name":"CRF230F"},{"id":33279,"name":"CRF125F"},{"id":33281,"name":"CRF150F"},{"id":33282,"name":"CRF150R"},{"id":33285,"name":"CRF250L"},{"id":33286,"name":"CRF250R"},{"id":33287,"name":"CRF250X"},{"id":33288,"name":"CRF50F"},{"id":33289,"name":"CRF110F"},{"id":33290,"name":"CRF450R"},{"id":33291,"name":"CRF450X"},{"id":33292,"name":"CRF250RX"},{"id":33293,"name":"CRF250F"},{"id":33294,"name":"CRF450RX"},{"id":33296,"name":"CRF450RWE"},{"id":33310,"name":"CRF450RL"},{"id":33319,"name":"CRF450L"},{"id":33499,"name":"XR650L"},{"id":33503,"name":"CBR600RR"},{"id":33505,"name":"CBR500R"},{"id":33508,"name":"CB500F"},{"id":33510,"name":"CB500X"},{"id":33515,"name":"CBR1000RR"},{"id":33518,"name":"CB1000R"},{"id":33524,"name":"CBR300R"},{"id":33535,"name":"CB300R"},{"id":33536,"name":"CBR650R"},{"id":33537,"name":"CB650R"},{"id":34886,"name":"Montesa Cota"},{"id":35229,"name":"Africa Twin"},{"id":35230,"name":"Fury"},{"id":36707,"name":"Foreman"},{"id":36708,"name":"Rubicon"},{"id":36711,"name":"Foreman Rubicon"},{"id":36712,"name":"Rancher"},{"id":36713,"name":"Recon"},{"id":36714,"name":"Rincon"},{"id":36953,"name":"Rebel 300"},{"id":36954,"name":"Rebel 500"},{"id":37126,"name":"Gold Wing Tour"},{"id":37127,"name":"Grom"},{"id":37131,"name":"Super Cub C125"},{"id":37132,"name":"Africa Twin Adventure Sports"},{"id":37133,"name":"SXS1000S (Talon 1000)"},{"id":37149,"name":"CBR600F"},{"id":37544,"name":"VTR250 (Interceptor 250)"},{"id":37555,"name":"VF750 (Interceptor 750)"}]},"meta":{"timestamp":"2026-05-29T23:29:03.444Z","request_id":"be9b2f2f-625e-499f-9e44-ecc151f9f447"},"status":"ok","message":"Models retrieved successfully","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":2500,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1100,"monthly_call_quota":40000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3400,"monthly_call_quota":200000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":8900,"monthly_call_quota":900000,"rps_limit":80,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/cars-api"}