VINdecode API 3.0 Documentation

// JavaScript / Node.js server-side example.
const tokenResponse = await fetch("https://identity.vinquery.com/connect/token", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET",
    audience: "vinquery:api:vindecode"
  })
});

const { jwtToken } = await tokenResponse.json();

const apiResponse = await fetch(
  "https://ws.vinquery.com/vindecode/v3?VIN=1FMCU0F76EUC78242&reportType=3&format=JSON",
  { headers: { Authorization: `Bearer ${jwtToken}` } }
);

console.log(await apiResponse.json());

import requests

token_response = requests.post(
    "https://identity.vinquery.com/connect/token",
    json={
        "clientId": "YOUR_CLIENT_ID",
        "clientSecret": "YOUR_CLIENT_SECRET",
        "audience": "vinquery:api:vindecode",
    },
)
token_response.raise_for_status()
jwt_token = token_response.json()["jwtToken"]

response = requests.get(
    "https://ws.vinquery.com/vindecode/v3",
    params={"VIN": "1FMCU0F76EUC78242", "reportType": "3", "format": "JSON"},
    headers={"Authorization": f"Bearer {jwt_token}"},
)
response.raise_for_status()
print(response.json())

<?php
$tokenRequest = json_encode([
    'clientId' => 'YOUR_CLIENT_ID',
    'clientSecret' => 'YOUR_CLIENT_SECRET',
    'audience' => 'vinquery:api:vindecode'
]);

$tokenCurl = curl_init('https://identity.vinquery.com/connect/token');
curl_setopt_array($tokenCurl, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $tokenRequest
]);
$tokenResult = json_decode(curl_exec($tokenCurl), true);
curl_close($tokenCurl);

$apiCurl = curl_init('https://ws.vinquery.com/vindecode/v3?VIN=1FMCU0F76EUC78242&reportType=3&format=JSON');
curl_setopt_array($apiCurl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $tokenResult['jwtToken']]
]);

$response = curl_exec($apiCurl);
curl_close($apiCurl);
echo $response;
?>

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
String tokenBody = "{\"clientId\":\"YOUR_CLIENT_ID\",\"clientSecret\":\"YOUR_CLIENT_SECRET\",\"audience\":\"vinquery:api:vindecode\"}";

HttpRequest tokenRequest = HttpRequest.newBuilder()
    .uri(URI.create("https://identity.vinquery.com/connect/token"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(tokenBody))
    .build();

String tokenJson = client.send(tokenRequest, HttpResponse.BodyHandlers.ofString()).body();
String jwtToken = tokenJson.replaceAll(".*\\\"jwtToken\\\"\\s*:\\s*\\\"([^\\\"]+)\\\".*", "$1");

HttpRequest apiRequest = HttpRequest.newBuilder()
    .uri(URI.create("https://ws.vinquery.com/vindecode/v3?VIN=1FMCU0F76EUC78242&reportType=3&format=JSON"))
    .header("Authorization", "Bearer " + jwtToken)
    .GET()
    .build();

String response = client.send(apiRequest, HttpResponse.BodyHandlers.ofString()).body();
System.out.println(response);

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    tokenPayload := []byte(`{"clientId":"YOUR_CLIENT_ID","clientSecret":"YOUR_CLIENT_SECRET","audience":"vinquery:api:vindecode"}`)
    tokenResp, err := http.Post("https://identity.vinquery.com/connect/token", "application/json", bytes.NewReader(tokenPayload))
    if err != nil {
        panic(err)
    }
    defer tokenResp.Body.Close()

    var tokenResult struct {
        JwtToken string `json:"jwtToken"`
    }
    if err := json.NewDecoder(tokenResp.Body).Decode(&tokenResult); err != nil {
        panic(err)
    }

    req, err := http.NewRequest("GET", "https://ws.vinquery.com/vindecode/v3?VIN=1FMCU0F76EUC78242&reportType=3&format=JSON", nil)
    if err != nil {
        panic(err)
    }
    req.Header.Set("Authorization", "Bearer "+tokenResult.JwtToken)

    apiResp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer apiResp.Body.Close()

    body, _ := io.ReadAll(apiResp.Body)
    fmt.Println(string(body))
}

using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;

using var http = new HttpClient();

var tokenPayload = "{\"clientId\":\"YOUR_CLIENT_ID\",\"clientSecret\":\"YOUR_CLIENT_SECRET\",\"audience\":\"vinquery:api:vindecode\"}";
var tokenResponse = await http.PostAsync(
    "https://identity.vinquery.com/connect/token",
    new StringContent(tokenPayload, Encoding.UTF8, "application/json"));
tokenResponse.EnsureSuccessStatusCode();

using var tokenJson = JsonDocument.Parse(await tokenResponse.Content.ReadAsStringAsync());
var jwtToken = tokenJson.RootElement.GetProperty("jwtToken").GetString();

using var request = new HttpRequestMessage(HttpMethod.Get, "https://ws.vinquery.com/vindecode/v3?VIN=1FMCU0F76EUC78242&reportType=3&format=JSON");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", jwtToken);

var response = await http.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());