PHPackages biegalski-llc/nhtsa-vehicle-api - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. biegalski-llc/nhtsa-vehicle-api ActiveLibrary[API Development](/categories/api) biegalski-llc/nhtsa-vehicle-api =============================== A package to consume the National Highway Traffic Safety Administration (NHSTA) Vehicles API for decoding VINs and pulling lists of Vehicle Year, Make and Model. v1.0.0(1y ago)1542.9k—1.9%9MITPHPPHP ~7.1|^8.0 Since Sep 25Pushed 8mo ago1 watchersCompare [ Source](https://github.com/Biegalski-LLC/NHTSA-Vehicle-API)[ Packagist](https://packagist.org/packages/biegalski-llc/nhtsa-vehicle-api)[ Docs](https://github.com/Biegalski-LLC/NHTSA-Vehicle-API)[ RSS](/packages/biegalski-llc-nhtsa-vehicle-api/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (4)Versions (11)Used By (0) NHTSA-Vehicle-API ================= [](#nhtsa-vehicle-api) [![Latest Version on Packagist](https://camo.githubusercontent.com/135904c18480cff8bac4976f7e3c828467b18d37f5f4ebb947de626b89916598/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f42696567616c736b692d4c4c432f4e485453412d56656869636c652d4150492e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/Biegalski-LLC/NHTSA-Vehicle-API)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/b441eda76996b4f3c9cb0568df0322697bf45d68faf9ef1dda321a1b6bf510ca/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f42696567616c736b692d4c4c432f4e485453412d56656869636c652d4150492f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/Biegalski-LLC/NHTSA-Vehicle-API)[![Coverage Status](https://camo.githubusercontent.com/18f2c492d219500084b00add3be35529deb58b8c2c7f7b68bf79b24ef58ce185/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f42696567616c736b692d4c4c432f4e485453412d56656869636c652d4150492e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/Biegalski-LLC/NHTSA-Vehicle-API/code-structure)[![Quality Score](https://camo.githubusercontent.com/62ceadbea6c8eacf96986c3ba2fadb29c539c5dc1253ef826f5cf1fd83a64a49/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f42696567616c736b692d4c4c432f4e485453412d56656869636c652d4150492e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/Biegalski-LLC/NHTSA-Vehicle-API)[![Total Downloads](https://camo.githubusercontent.com/6bcc35edf986f1464a8e6e1e98ceb24c0755c35aa75ea17cf3e7782a55380721/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f42696567616c736b692d4c4c432f4e485453412d56656869636c652d4150492e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/Biegalski-LLC/NHTSA-Vehicle-API) A package to consume the National Highway Traffic Safety Administration (NHSTA) Vehicles API for decoding VINs and pulling lists of Vehicle Year, Make and Model. Install ------- [](#install) Via Composer ``` $ composer require biegalski-llc/nhtsa-vehicle-api ``` Usage ----- [](#usage) All methods return an alphabetized array of data. #### Initialize [](#initialize) ``` use BiegalskiLLC\NHTSAVehicleAPI\VehicleApi; $vehicles = new VehicleApi(); ``` #### Get Years List [](#get-years-list) This method will allow you to pull a generated list of years. It accepts a parameter for the earliest year you want to start at and runs up to two years past the current year (to match some make/models are release schedules). ``` $vehicles->listYears(); $vehicles->listYears(1990); $vehicles->listYears(1960); ``` #### Get All Makes [](#get-all-makes) This method will allow you to pull a live listing of all vehicle makes from the NHSTA Vehicles API. The data will include the *Make Name* and *Make ID*. ``` $vehicles->listAllMakes(); ``` #### Get Pre-Loaded List Of Makes [](#get-pre-loaded-list-of-makes) Considering the make list is extremely extensive from the NHSTA Vehicles API we have curated our own pre-loaded list of commonly used makes in the United States. The data will include the *Make Name* and *Make ID*. It defaults to a mix of car/truck makes and motorcycle/scooter makes. It accepts an optional parameter to only pull car/truck or motorcycle/scooter makes as well. ``` $vehicles->listPreloadedMakes(); $vehicles->listPreloadedMakes('car/truck'); $vehicles->listPreloadedMakes('motorcycle/scooter'); ``` You can review the default list at: `biegalski-llc/nhtsa-vehicle-api/config/VehicleMakes/preloadedMakeList.php` You can review the car/truck make list at: `biegalski-llc/nhtsa-vehicle-api/config/VehicleMakes/preloadedCarMakeList.php` You can review the motorcycle/scooter make list at: `biegalski-llc/nhtsa-vehicle-api/config/VehicleMakes/preloadedMotoMakeList.php` #### Get Accepted List Of Makes [](#get-accepted-list-of-makes) Considering the make list is extremely extensive from the NHSTA Vehicles API we have another method which accepts an array parameter of all of the makes you would like to pull. The accepted list should be an array of Make ID's from the NHSTA Vehicles API. The data will include the *Make Name* and *Make ID*. ``` $vehicles->listAcceptedListMakes([6124,9172]); ``` #### Get All Models By Make [](#get-all-models-by-make) This method will allow you to pull a live listing of all vehicle models for a vehicle make. It requires a Make ID integer as a parameter. The data will include the *Make Name*, *Make ID*, *Model Name* and *Model ID*. ``` $vehicles->listModelsByMake(460); ``` #### Get All Models By Make and Year [](#get-all-models-by-make-and-year) This method will allow you to pull a live listing of all vehicle models for a vehicle make by year. It requires a Make ID integer and Year integer as parameters. The data will include the *Make Name*, *Make ID*, *Model Name* and *Model ID*. ``` $vehicles->listModelsByMakeYear(460, 2020); ``` #### Use VIN Decoder [](#use-vin-decoder) This method will allow you to decode a VIN to get information on that particular vehicle. ``` $vehicles->decodeVin('1J4GZ58S7VC697710'); ``` Change log ---------- [](#change-log) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Testing ------- [](#testing) ``` $ composer test ``` Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) and [CODE\_OF\_CONDUCT](CODE_OF_CONDUCT.md) for details. Security -------- [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Michael Biegalski](https://github.com/Biegalski-LLC) - Biegalski LLC - [Franco Petitfour](https://github.com/0456franco) - Added curated motorcycle/scooter list License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 47 — FairBetter than 94% of packages Maintenance54 Moderate activity, may be stable Popularity39 Limited adoption so far Community14 Small or concentrated contributor base Maturity66 Established project with proven stability Bus Factor1 Top contributor holds 85.2% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~186 days Recently: every ~339 days Total 10 Last Release 384d ago Major Versions v0.0.9 → v1.0.02025-04-29 PHP version history (3 changes)v0.0.1PHP ~7.1 v0.0.7PHP ~7.1|~8.0 v0.0.8PHP ~7.1|^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/70faf37cc3ff7910e0d0cf44f135832da9cda59ee2f34904abdd83cbb97d0bf3?d=identicon)[Biegalski-LLC](/maintainers/Biegalski-LLC) --- Top Contributors [![Biegalski-LLC](https://avatars.githubusercontent.com/u/20915124?v=4)](https://github.com/Biegalski-LLC "Biegalski-LLC (23 commits)")[![adriancarli](https://avatars.githubusercontent.com/u/11067364?v=4)](https://github.com/adriancarli "adriancarli (2 commits)")[![topmiamisoftware](https://avatars.githubusercontent.com/u/45574055?v=4)](https://github.com/topmiamisoftware "topmiamisoftware (2 commits)") --- Tags Biegalski-LLCNHTSA-Vehicle-API ### Code Quality TestsPHPUnit Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/biegalski-llc-nhtsa-vehicle-api/health.svg) ``` [![Health](https://phpackages.com/badges/biegalski-llc-nhtsa-vehicle-api/health.svg)](https://phpackages.com/packages/biegalski-llc-nhtsa-vehicle-api) ``` ### Alternatives [statamic/cms The Statamic CMS Core Package 4.8k3.2M720](/packages/statamic-cms)[ashallendesign/laravel-exchange-rates A wrapper package for interacting with the exchangeratesapi.io API. 485677.8k](/packages/ashallendesign-laravel-exchange-rates)[tencentcloud/tencentcloud-sdk-php TencentCloudApi php sdk 3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[vluzrmos/slack-api Wrapper for Slack.com WEB API. 102589.1k3](/packages/vluzrmos-slack-api)[smodav/mpesa M-Pesa API implementation 16363.7k1](/packages/smodav-mpesa)[codebar-ag/laravel-docuware DocuWare integration with Laravel 1221.1k](/packages/codebar-ag-laravel-docuware) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)