PHPackages amattu2/vinwiki-wrapper - 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. amattu2/vinwiki-wrapper ActiveLibrary[API Development](/categories/api) amattu2/vinwiki-wrapper ======================= A VINwiki.com API wrapper. Opens up access to VINWiki API functionality; Fetch feeds by a VIN, use plate2vin (pl82vin), add a new event to a feed, etc. v1.0.5(1y ago)331[1 issues](https://github.com/amattu2/VINwiki-Wrapper/issues)AGPL-3.0-onlyPHPPHP >=7.4 Since Mar 9Pushed 1y ago1 watchersCompare [ Source](https://github.com/amattu2/VINwiki-Wrapper)[ Packagist](https://packagist.org/packages/amattu2/vinwiki-wrapper)[ RSS](/packages/amattu2-vinwiki-wrapper/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)DependenciesVersions (7)Used By (0) Introduction ============ [](#introduction) This is an unofficial and dependency-free [VINwiki.com](https://vinwiki.com) API wrapper written PHP. It offers a simple interface for interacting with the VINwiki API. Among other things, it allows you to: - Read and update user profiles - Read and update vehicle information - Read, create, and delete posts - Decode license plates by country and state - Search for vehicles by VIN, Year, Make, Model, or free-text Usage ===== [](#usage) Installation ------------ [](#installation) Via Composer ``` composer require amattu2/vinwiki-wrapper ``` Then, require Composer's autoloader: ``` require 'vendor/autoload.php'; ``` Instantiate the class: ``` $wrapper = new amattu2\VINwiki\Client("email|username", "password"); ``` Functions --------- [](#functions) ### People [](#people) These functions relate to person interactions. getPersonProfile(string $uuid = "") : ?VINwiki\\Models\\PersonReturns a VINwiki user profile. If no user is specified, the current user's profile is returned. ``` // for the current user print_r($wrapper->getPersonProfile()); // or for a specific user print_r($wrapper->getPersonProfile("61382da4-25c6-494f-8065-87afdfb4f50d")); ``` updatePersonProfile(string $uuid, VINwiki\\Models\\Person $person): ?VINwiki\\Models\\PersonUpdates the current user's profile. Returns the updated profile on success. The only required field is "email". See [Models\\Person](src/models/Person.php) for more fields. ``` $person = new amattu2\VINwiki\Models\Person([ "email" => "abc123@example.com", ]); print_r($wrapper->updatePersonProfile("{UUID GOES HERE}", $person)); ``` getPersonNotifications() : ?arrayGet the current user's notifications. ``` print_r($wrapper->getPersonNotifications()); ``` getPersonFeed(string $uuid = "", bool $filterFollowing = true): ?Models\\PersonFeedGet a user's post feed. If no `$uuid` is specified, the current user's feed is returned. If `$filterFollowing` is true, only the posts for vehicles/people that the specified user is following will be returned. ``` // for the current user print_r($wrapper->getPersonFeed()); // or for a specific user print_r($wrapper->getPersonFeed("61382da4-25c6-494f-8065-87afdfb4f50d", false)); ``` getPersonPosts(string $uuid = ""): ?VINwiki\\Models\\PersonPostsGet a user's posts. If no user is specified, the current user's posts are returned. ``` // for the current user print_r($wrapper->getPersonPosts()); // or for a specific user print_r($wrapper->getPersonPosts("61382da4-25c6-494f-8065-87afdfb4f50d")); ``` getRecentVins(): ?VINwiki\\Models\\RecentVinsReturns a list of vehicles the user has recently posted on or interacted with. Does not include vehicles that the user has only viewed. ``` print_r($wrapper->getRecentVins()); ``` ### Vehicles [](#vehicles) These functions handle any vehicle-related interactions. plateLookup(string $plate, string $country, string $state): ?VINwiki\\Models\\PlateLookupReturns a vehicle decoded by the license plate. Currently supports US/UK plates. ``` print_r($wrapper->plateLookup("HELLO", "US", "CA")); ``` getFeed(string $vin): ?VINwiki\\Models\\VehicleFeedGet a vehicle's post feed (i.e. when you visit a vehicle's page on VINwiki.com) ``` print_r($wrapper->getFeed("WBAPL33579A406957")); ``` getVehicle(string $vin): ?VINwiki\\Models\\VehicleGet a vehicle's information by VIN. ``` print_r($wrapper->getVehicle("WBAPL33579A406957")); ``` vehicleSearch(string $query): ?VINwiki\\Models\\VehicleSearchPerform a free-text search for vehicles by Year, Make, Model, or VIN. ``` print_r($wrapper->vehicleSearch("2011 Toyota Corolla")); ``` updateVehicle(string $vin, int $year, string $make, string $model, string $trim = ""): boolUpdate a vehicle's Year, Make, Model, and Trim by VIN. Returns true if successful. ``` print_r($wrapper->updateVehicle("WBAPL33579A406957", 2009, "BMW", "335i", "xDrive")); ``` createPost(string $vin, VINwiki\\Models\\VehiclePost $post): ?VINwiki\\Models\\FeedPostCreate a new post on a vehicle. Requires a VIN and a VehiclePost object. Returns the new post on success. See [Models\\VehiclePost](src/models/VehiclePost.php) for more information. ``` // Create a new post class $post = new amattu2\VINwiki\Models\VehiclePost([ "mileage" => 43000, "text" => "This is a test post from the VINwiki-Wrapper PHP library.", ]); // Post it print_r($wrapper->createPost("WBAPL33579A406957", $post)); ``` deletePost(string $uuid) : boolDelete a post by UUID. Returns true if successful. Requires the user to be the author of the post. ``` print_r($wrapper->deletePost("61382da4-25c6-494f-8065-87afdfb4f50d")); ``` Requirements ============ [](#requirements) - PHP 7.4+ - cURL - Composer (Preferred) ### Health Score 26 — LowBetter than 43% of packages Maintenance29 Infrequent updates — may be unmaintained Popularity10 Limited adoption so far Community7 Small or concentrated contributor base Maturity49 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~112 days Recently: every ~139 days Total 6 Last Release 596d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/45d27ac587ba85712309c969ca2e277df1044c60ce9f2f8a5ca69118211e30d6?d=identicon)[amattu2](/maintainers/amattu2) --- Top Contributors [![amattu2](https://avatars.githubusercontent.com/u/38357871?v=4)](https://github.com/amattu2 "amattu2 (50 commits)") --- Tags apiphpvinwikiwrapper ### Embed Badge ![Health badge](/badges/amattu2-vinwiki-wrapper/health.svg) ``` [![Health](https://phpackages.com/badges/amattu2-vinwiki-wrapper/health.svg)](https://phpackages.com/packages/amattu2-vinwiki-wrapper) ``` ### Alternatives [stripe/stripe-php Stripe PHP Library 4.0k143.3M478](/packages/stripe-stripe-php)[twilio/sdk A PHP wrapper for Twilio's API 1.6k92.9M271](/packages/twilio-sdk)[knplabs/github-api GitHub API v3 client 2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk PHP SDK for Facebook Business 90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php PHP wrapper for the Meilisearch API 73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax Google API Core for PHP 263103.1M454](/packages/google-gax) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)