{ "info": { "name": "Vehicle API", "_postman_id": "vehicle-api-v1", "description": "Decode VINs, pull official US recalls, complaints and NCAP ratings, and look up Dutch plates. Docs: https://vehicles-api.com/docs", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key", "type": "string" }, { "key": "value", "value": "{{api_key}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "item": [ { "name": "VIN decoding", "item": [ { "name": "Decode", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/vin/decode", "host": [ "{{base_url}}" ], "path": [ "vin", "decode" ] }, "description": "Year, make, model, trim, engine, transmission and assembly plant for any 17-character VIN. Docs: https://vehicles-api.com/docs#vin-decode", "body": { "mode": "raw", "raw": "{\n \"vin\": \"1HGCM82633A004352\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "Example · 200", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/vin/decode", "host": [ "{{base_url}}" ], "path": [ "vin", "decode" ] }, "description": "Year, make, model, trim, engine, transmission and assembly plant for any 17-character VIN. Docs: https://vehicles-api.com/docs#vin-decode", "body": { "mode": "raw", "raw": "{\n \"vin\": \"1HGCM82633A004352\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"source\": \"nhtsa\",\n \"data\": {\n \"vin\": \"1HGCM82633A004352\",\n \"valid\": true,\n \"year\": 2003,\n \"make\": \"HONDA\",\n \"model\": \"Accord\",\n \"trim\": \"EX-V6\",\n \"body\": \"Coupe\",\n \"doors\": 2,\n \"vehicle_type\": \"PASSENGER CAR\",\n \"engine\": {\n \"cylinders\": 6,\n \"displacement_l\": 3,\n \"configuration\": \"V-Shaped\",\n \"model\": \"J30A4\",\n \"hp\": 240,\n \"fuel\": \"Gasoline\"\n },\n \"drive\": null,\n \"transmission\": {\n \"style\": \"Automatic\",\n \"speeds\": 5\n },\n \"plant\": {\n \"country\": \"UNITED STATES (USA)\",\n \"city\": \"MARYSVILLE\",\n \"state\": \"OHIO\"\n },\n \"manufacturer\": \"AMERICAN HONDA MOTOR CO., INC.\"\n }\n}" } ] }, { "name": "Full report", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/vin/report", "host": [ "{{base_url}}" ], "path": [ "vin", "report" ] }, "description": "Specs, open recalls, complaint count and crash ratings in a single call. Docs: https://vehicles-api.com/docs#vin-report", "body": { "mode": "raw", "raw": "{\n \"vin\": \"1HGCM82633A004352\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "Example · 200", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/vin/report", "host": [ "{{base_url}}" ], "path": [ "vin", "report" ] }, "description": "Specs, open recalls, complaint count and crash ratings in a single call. Docs: https://vehicles-api.com/docs#vin-report", "body": { "mode": "raw", "raw": "{\n \"vin\": \"1HGCM82633A004352\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"source\": \"nhtsa\",\n \"data\": {\n \"vin\": \"1HGCM82633A004352\",\n \"valid\": true,\n \"year\": 2003,\n \"make\": \"HONDA\",\n \"model\": \"Accord\",\n \"trim\": \"EX-V6\",\n \"body\": \"Coupe\",\n \"doors\": 2,\n \"vehicle_type\": \"PASSENGER CAR\",\n \"engine\": {\n \"cylinders\": 6,\n \"displacement_l\": 3,\n \"fuel\": \"Gasoline\"\n },\n \"plant\": {\n \"country\": \"UNITED STATES (USA)\",\n \"city\": \"MARYSVILLE\",\n \"state\": \"OHIO\"\n },\n \"manufacturer\": \"AMERICAN HONDA MOTOR CO., INC.\",\n \"coverage\": \"us\",\n \"recalls_count\": 24,\n \"recalls\": [\n {\n \"campaign\": \"19V182000\",\n \"component\": \"AIR BAGS:FRONTAL:DRIVER SIDE:INFLATOR MODULE\",\n \"received\": \"2019-03-06\",\n \"summary\": \"Replacement driver air bag inflator may explode.\",\n \"consequence\": \"Sharp metal fragments may strike occupants.\",\n \"remedy\": \"Dealers will replace the inflator, free of charge.\"\n }\n ],\n \"complaints_count\": 2013,\n \"safety_ratings\": {\n \"match\": \"partial\",\n \"vehicle_description\": \"2003 Honda Accord 2-DR.\",\n \"overall\": null,\n \"front\": {\n \"driver\": 5,\n \"passenger\": 5\n },\n \"side\": {\n \"driver\": 5,\n \"passenger\": 5\n },\n \"rollover\": 4\n }\n }\n}" } ] }, { "name": "Validate", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/vin/validate", "host": [ "{{base_url}}" ], "path": [ "vin", "validate" ] }, "description": "Format and ISO 3779 check-digit validation, computed locally (no upstream call). Docs: https://vehicles-api.com/docs#vin-validate", "body": { "mode": "raw", "raw": "{\n \"vin\": \"1HGCM82633A004352\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "Example · 200", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/vin/validate", "host": [ "{{base_url}}" ], "path": [ "vin", "validate" ] }, "description": "Format and ISO 3779 check-digit validation, computed locally (no upstream call). Docs: https://vehicles-api.com/docs#vin-validate", "body": { "mode": "raw", "raw": "{\n \"vin\": \"1HGCM82633A004352\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"source\": \"local\",\n \"data\": {\n \"vin\": \"1HGCM82633A004352\",\n \"valid\": true,\n \"check_digit\": \"3\"\n }\n}" } ] } ] }, { "name": "Safety & recalls", "item": [ { "name": "Recalls", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/vin/recalls?vin=1HGCM82633A004352", "host": [ "{{base_url}}" ], "path": [ "vin", "recalls" ], "query": [ { "key": "vin", "value": "1HGCM82633A004352" } ] }, "description": "Official NHTSA recall campaigns for the decoded year / make / model. Docs: https://vehicles-api.com/docs#vin-recalls" }, "response": [ { "name": "Example · 200", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/vin/recalls?vin=1HGCM82633A004352", "host": [ "{{base_url}}" ], "path": [ "vin", "recalls" ], "query": [ { "key": "vin", "value": "1HGCM82633A004352" } ] }, "description": "Official NHTSA recall campaigns for the decoded year / make / model. Docs: https://vehicles-api.com/docs#vin-recalls" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"source\": \"nhtsa\",\n \"data\": {\n \"vin\": \"1HGCM82633A004352\",\n \"year\": 2003,\n \"make\": \"HONDA\",\n \"model\": \"Accord\",\n \"coverage\": \"us\",\n \"count\": 24,\n \"recalls\": [\n {\n \"campaign\": \"19V182000\",\n \"component\": \"AIR BAGS:FRONTAL:DRIVER SIDE:INFLATOR MODULE\",\n \"received\": \"2019-03-06\",\n \"summary\": \"Replacement driver air bag inflator may explode.\",\n \"consequence\": \"Sharp metal fragments may strike occupants.\",\n \"remedy\": \"Dealers will replace the inflator, free of charge.\"\n }\n ]\n }\n}" } ] }, { "name": "Recalls by model", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/recalls?make=BMW&model=320i&year=2002", "host": [ "{{base_url}}" ], "path": [ "recalls" ], "query": [ { "key": "make", "value": "BMW" }, { "key": "model", "value": "320i" }, { "key": "year", "value": "2002" } ] }, "description": "US-market NHTSA recall campaigns for a make, model and year — no VIN needed. Zero campaigns is a 200 with an empty list. Docs: https://vehicles-api.com/docs#recalls" }, "response": [ { "name": "Example · 200", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/recalls?make=BMW&model=320i&year=2002", "host": [ "{{base_url}}" ], "path": [ "recalls" ], "query": [ { "key": "make", "value": "BMW" }, { "key": "model", "value": "320i" }, { "key": "year", "value": "2002" } ] }, "description": "US-market NHTSA recall campaigns for a make, model and year — no VIN needed. Zero campaigns is a 200 with an empty list. Docs: https://vehicles-api.com/docs#recalls" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"source\": \"nhtsa\",\n \"data\": {\n \"year\": 2002,\n \"make\": \"BMW\",\n \"model\": \"320i\",\n \"coverage\": \"us\",\n \"count\": 1,\n \"recalls\": [\n {\n \"campaign\": \"20V018000\",\n \"component\": \"AIR BAGS:FRONTAL:PASSENGER SIDE:INFLATOR MODULE\",\n \"received\": \"2020-01-15\",\n \"summary\": \"BMW is recalling certain 2000-2006 3 Series vehicles equipped with Takata PSAN passenger frontal air bag inflators.\",\n \"consequence\": \"An inflator explosion may result in sharp metal fragments striking the driver or other occupants.\",\n \"remedy\": \"Dealers will replace the passenger front air bag, free of charge.\"\n }\n ]\n }\n}" } ] }, { "name": "Complaints", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/vin/complaints?vin=1HGCM82633A004352", "host": [ "{{base_url}}" ], "path": [ "vin", "complaints" ], "query": [ { "key": "vin", "value": "1HGCM82633A004352" } ] }, "description": "Owner complaints filed with NHTSA ODI — the 50 most recent, plus the true total. Docs: https://vehicles-api.com/docs#vin-complaints" }, "response": [ { "name": "Example · 200", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/vin/complaints?vin=1HGCM82633A004352", "host": [ "{{base_url}}" ], "path": [ "vin", "complaints" ], "query": [ { "key": "vin", "value": "1HGCM82633A004352" } ] }, "description": "Owner complaints filed with NHTSA ODI — the 50 most recent, plus the true total. Docs: https://vehicles-api.com/docs#vin-complaints" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"source\": \"nhtsa\",\n \"data\": {\n \"vin\": \"1HGCM82633A004352\",\n \"year\": 2003,\n \"make\": \"HONDA\",\n \"model\": \"Accord\",\n \"coverage\": \"us\",\n \"count\": 2013,\n \"complaints\": [\n {\n \"odi_number\": \"11459899\",\n \"date\": \"2022-03-15\",\n \"crash\": false,\n \"fire\": false,\n \"injured\": 0,\n \"deaths\": 0,\n \"components\": [\n \"AIR BAGS\"\n ],\n \"summary\": \"Driver airbag warning light illuminated.\"\n }\n ]\n }\n}" } ] }, { "name": "Safety ratings", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/vin/safety-ratings?vin=1HGCM82633A004352", "host": [ "{{base_url}}" ], "path": [ "vin", "safety-ratings" ], "query": [ { "key": "vin", "value": "1HGCM82633A004352" } ] }, "description": "NHTSA NCAP crash-test stars: frontal, side and rollover. Docs: https://vehicles-api.com/docs#vin-safety-ratings" }, "response": [ { "name": "Example · 200", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/vin/safety-ratings?vin=1HGCM82633A004352", "host": [ "{{base_url}}" ], "path": [ "vin", "safety-ratings" ], "query": [ { "key": "vin", "value": "1HGCM82633A004352" } ] }, "description": "NHTSA NCAP crash-test stars: frontal, side and rollover. Docs: https://vehicles-api.com/docs#vin-safety-ratings" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"source\": \"nhtsa\",\n \"data\": {\n \"vin\": \"1HGCM82633A004352\",\n \"coverage\": \"us\",\n \"match\": \"partial\",\n \"vehicle_description\": \"2003 Honda Accord 2-DR.\",\n \"overall\": null,\n \"front\": {\n \"overall\": null,\n \"driver\": 5,\n \"passenger\": 5\n },\n \"side\": {\n \"overall\": null,\n \"driver\": 5,\n \"passenger\": 5\n },\n \"rollover\": 4,\n \"nhtsa_vehicle_id\": 4736\n }\n}" } ] } ] }, { "name": "License plates", "item": [ { "name": "Netherlands", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/plate/nl", "host": [ "{{base_url}}" ], "path": [ "plate", "nl" ] }, "description": "Dutch RDW registration record for a kenteken (plate). RDW data never includes the VIN. Docs: https://vehicles-api.com/docs#plate-nl", "body": { "mode": "raw", "raw": "{\n \"plate\": \"K875HJ\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "Example · 200", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/plate/nl", "host": [ "{{base_url}}" ], "path": [ "plate", "nl" ] }, "description": "Dutch RDW registration record for a kenteken (plate). RDW data never includes the VIN. Docs: https://vehicles-api.com/docs#plate-nl", "body": { "mode": "raw", "raw": "{\n \"plate\": \"K875HJ\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"source\": \"plate_nl\",\n \"data\": {\n \"plate\": \"K875HJ\",\n \"vin\": null,\n \"year\": 2021,\n \"make\": \"TOYOTA\",\n \"model\": \"AYGO\",\n \"body\": \"hatchback\",\n \"color\": \"GRIJS\",\n \"doors\": 4,\n \"seats\": 4,\n \"vehicle_type\": \"Personenauto\",\n \"engine\": {\n \"cylinders\": 3,\n \"displacement_cc\": 998,\n \"fuel\": \"Benzine\"\n },\n \"mass_kg\": 815,\n \"apk_expires\": \"2027-01-04\",\n \"first_registration\": \"2021-01-04\",\n \"open_recall\": false\n }\n}" } ] }, { "name": "United States", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/plate/us", "host": [ "{{base_url}}" ], "path": [ "plate", "us" ] }, "description": "Plate + state → VIN → specs, via a plate-to-VIN vendor. Returns upstream_unavailable until a vendor key is configured. Docs: https://vehicles-api.com/docs#plate-us", "body": { "mode": "raw", "raw": "{\n \"plate\": \"7ABC123\",\n \"state\": \"CA\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "Example · 200", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/plate/us", "host": [ "{{base_url}}" ], "path": [ "plate", "us" ] }, "description": "Plate + state → VIN → specs, via a plate-to-VIN vendor. Returns upstream_unavailable until a vendor key is configured. Docs: https://vehicles-api.com/docs#plate-us", "body": { "mode": "raw", "raw": "{\n \"plate\": \"7ABC123\",\n \"state\": \"CA\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"source\": \"plate_us\",\n \"data\": {\n \"plate\": \"7ABC123\",\n \"state\": \"CA\",\n \"vin\": \"1HGCM82633A004352\",\n \"year\": 2003,\n \"make\": \"HONDA\",\n \"model\": \"Accord\",\n \"trim\": \"EX-V6\",\n \"body\": \"Coupe\",\n \"vehicle_type\": \"PASSENGER CAR\"\n }\n}" } ] }, { "name": "US states", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/plate/us/states", "host": [ "{{base_url}}" ], "path": [ "plate", "us", "states" ] }, "description": "The US states (USPS codes) covered by plate lookups. Static reference data. Docs: https://vehicles-api.com/docs#plate-us-states" }, "response": [ { "name": "Example · 200", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/plate/us/states", "host": [ "{{base_url}}" ], "path": [ "plate", "us", "states" ] }, "description": "The US states (USPS codes) covered by plate lookups. Static reference data. Docs: https://vehicles-api.com/docs#plate-us-states" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"source\": \"plate_us\",\n \"data\": {\n \"states\": [\n {\n \"code\": \"AL\",\n \"name\": \"Alabama\"\n },\n {\n \"code\": \"AK\",\n \"name\": \"Alaska\"\n },\n {\n \"code\": \"…\",\n \"name\": \"51 entries in total\"\n }\n ]\n }\n}" } ] } ] } ], "variable": [ { "key": "base_url", "value": "https://vehicles-api.com/api/v1" }, { "key": "api_key", "value": "YOUR_API_KEY" } ] }