VINbarcode API 3.0 Documentation

// JavaScript / Node.js server-side example.
import { readFile } from "node:fs/promises";

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:vinbarcode"
  })
});
const { jwtToken } = await tokenResponse.json();

const form = new FormData();
form.append("file", new Blob([await readFile("./vin-barcode.jpg")]), "vin-barcode.jpg");

const response = await fetch("https://www.recognition.ws/vinbarcode/v3?vindecode=TRUE&format=JSON", {
  method: "POST",
  headers: { Authorization: `Bearer ${jwtToken}` },
  body: form
});

console.log(await response.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:vinbarcode",
    },
)
token_response.raise_for_status()
jwt_token = token_response.json()["jwtToken"]

with open("vin-barcode.jpg", "rb") as image:
    response = requests.post(
        "https://www.recognition.ws/vinbarcode/v3",
        params={"vindecode": "TRUE", "format": "JSON"},
        headers={"Authorization": f"Bearer {jwt_token}"},
        files={"file": ("vin-barcode.jpg", image, "image/jpeg")},
    )
response.raise_for_status()
print(response.json())

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

$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://www.recognition.ws/vinbarcode/v3?vindecode=TRUE&format=JSON');
curl_setopt_array($apiCurl, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $tokenResult['jwtToken']],
    CURLOPT_POSTFIELDS => ['file' => new CURLFile('vin-barcode.jpg')]
]);

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

import java.io.File;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.ByteBuffer;
import java.nio.file.Files;
import java.util.UUID;

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

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");

File image = new File("vin-barcode.jpg");
String boundary = "----VinqueryBoundary" + UUID.randomUUID();
byte[] fileBytes = Files.readAllBytes(image.toPath());
String header = "--" + boundary + "\r\n"
    + "Content-Disposition: form-data; name=\"file\"; filename=\"" + image.getName() + "\"\r\n"
    + "Content-Type: image/jpeg\r\n\r\n";
String footer = "\r\n--" + boundary + "--\r\n";
byte[] body = ByteBuffer.allocate(header.getBytes().length + fileBytes.length + footer.getBytes().length)
    .put(header.getBytes())
    .put(fileBytes)
    .put(footer.getBytes())
    .array();

HttpRequest apiRequest = HttpRequest.newBuilder()
    .uri(URI.create("https://www.recognition.ws/vinbarcode/v3?vindecode=TRUE&format=JSON"))
    .header("Authorization", "Bearer " + jwtToken)
    .header("Content-Type", "multipart/form-data; boundary=" + boundary)
    .POST(HttpRequest.BodyPublishers.ofByteArray(body))
    .build();

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

package main

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

func main() {
    tokenPayload := []byte(`{"clientId":"YOUR_CLIENT_ID","clientSecret":"YOUR_CLIENT_SECRET","audience":"vinquery:api:vinbarcode"}`)
    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)
    }

    var body bytes.Buffer
    writer := multipart.NewWriter(&body)
    file, err := os.Open("vin-barcode.jpg")
    if err != nil {
        panic(err)
    }
    defer file.Close()

    part, err := writer.CreateFormFile("file", "vin-barcode.jpg")
    if err != nil {
        panic(err)
    }
    if _, err := io.Copy(part, file); err != nil {
        panic(err)
    }
    writer.Close()

    req, err := http.NewRequest("POST", "https://www.recognition.ws/vinbarcode/v3?vindecode=TRUE&format=JSON", &body)
    if err != nil {
        panic(err)
    }
    req.Header.Set("Authorization", "Bearer "+tokenResult.JwtToken)
    req.Header.Set("Content-Type", writer.FormDataContentType())

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

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

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:vinbarcode\"}";
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 form = new MultipartFormDataContent();
var imageContent = new ByteArrayContent(await File.ReadAllBytesAsync("vin-barcode.jpg"));
imageContent.Headers.ContentType = new MediaTypeHeaderValue("image/jpeg");
form.Add(imageContent, "file", "vin-barcode.jpg");

using var request = new HttpRequestMessage(HttpMethod.Post, "https://www.recognition.ws/vinbarcode/v3?vindecode=TRUE&format=JSON");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", jwtToken);
request.Content = form;

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