PlateToVin API Documentation

This documentation will showcase the basics of using the PlateToVin HTTP API. It's really simple to use!

Introduction

The PlateToVin API is a HTTP API, it follows REST principles and uses SSL all-around. The API is super simple to integrate into any application.

Authentication

To authenticate with the API, you will need to have your API key which is found by logging into the dashboard and clicking your name on the navbar, you will see the API key and have the ability to re-generate it.

With any request, to authenticate, simply add the following header to the request:

Authorization: API KEY

POST /convert - Convert a License Plate to VIN

This endpoint is the primary endpoint for the API. To use this endpoint, send a get request to:

https://platetovin.net/api/convert

The body of this request should be:

{
    "plate": "License Plate to Convert",
    "state": "State that the plate belongs to"
}

The plate should include no spacing.
The state should be the states 2 letter state code (ISO 3166-2:US)

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://platetovin.net/api/convert', [
    'headers' => [
        'Authorization' => 'API Key',
        'Content-Type' => 'application/json',
    ],
    'json' => [
        'plate' => 'license plate',
        'state' => 'state'
    ]
]);

echo $response->getBody();
using System.Net.Http;

HttpClient client = new HttpClient();

var values = new Dictionary
{
  { "plate", "8DME347" },
  { "state", "CA" }
};

var content = new FormUrlEncodedContent(values);

var request = new HttpRequestMessage(HttpMethod.Post, "https://platetovin.net/api/convert");
request.Headers.Add("Authorization", "API KEY HERE");
request.Content = content;

var response = await client.SendAsync(request);

var responseString = await response.Content.ReadAsStringAsync();

Console.WriteLine(responseString);

A response to a request would look like:

{
    "vin": "3GCPWBEK9LG168514",
    "year": "2020",
    "make": "Chevrolet",
    "model": "Silverado 1500",
    "trim": "Custom",
    "name": "2020 Chevrolet Silverado 1500",
    "engine": "2.7L L4 DOHC 16V TURBO",
    "style": "Pickup",
    "transmission": "Automatic",
    "driveType": "RWD",
    "fuel": "Gasoline",
    "color": {
        "name": "Black",
        "abbreviation": "BLK"
    }
}