VIN Lookup

GET

api

vin

VIN Lookup

curl --request GET \
  --url https://www.osintcat.net/api/vin \
  --header 'X-API-KEY: <x-api-key>'

import requests

url = "https://www.osintcat.net/api/vin"

headers = {"X-API-KEY": "<x-api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-KEY': '<x-api-key>'}};

fetch('https://www.osintcat.net/api/vin', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.osintcat.net/api/vin",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.osintcat.net/api/vin"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://www.osintcat.net/api/vin")
  .header("X-API-KEY", "<x-api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.osintcat.net/api/vin")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

Decode Vehicle Identification Numbers (VINs) and query vehicle data from the NHTSA vPIC API. Supports single/batch VIN decode, WMI decode, makes & models, manufacturers, vehicle variables, and Canadian vehicle specifications.

Headers

X-API-KEY

string

required

Your API key

Parameters

All requests require a type parameter. Other parameters depend on the operation. Use the fields below in the Try it panel; the tables describe which apply to each type.

type

string

required

Operation type

query

string

VIN (decode/batch), WMI code (wmi), or search term (makes, manufacturers, variables). Not used for canadian.

model_year

number

Model year 1981+. For type=decode only. Recommended for partial VINs.

extended

boolean

default:"false"

If true, include extended NHTSA variables. For type=decode only.

search_type

string

Sub-operation. Required for type=makes, manufacturers, variables.

year

number

Model year. For type=makes (manufacturer, models) and type=canadian (required).

vehicle_type

string

e.g. Passenger Car, Truck. For type=makes (models) and type=manufacturers (wmis).

mfr_type

string

Manufacturer type filter. For type=manufacturers, search_type=all.

from_date

string

Start date. Required for type=manufacturers, search_type=parts.

to_date

string

End date. Required for type=manufacturers, search_type=parts.

parts_type

string

default:"565"

Parts doc type. For type=manufacturers, search_type=parts. Default: 565.

page

number

default:"1"

Page number. For type=manufacturers. Default: 1.

make

string

Make. Required for type=canadian.

model

string

Model name. For type=canadian.

units

string

default:"Metric"

Units for type=canadian. Metric or Imperial (Imperial is sent as US to the API). Default: Metric.

type: `decode`

Decode a 17-digit VIN or partial VIN (use * for missing characters).

Parameter	Type	Required	Description
query	string	Yes	VIN (6–17 chars) or partial VIN
model_year	int	No	Model year (1981+). Recommended for pre-1980.
extended	bool	No	`true` for extended NHTSA variables. Default: `false`.

type: `batch`

Decode up to 50 VINs at once. One per line; optional format: VIN, model_year.

Parameter	Type	Required	Description
query	string	Yes	VINs, one per line. Max 50.

type: `wmi`

Decode a World Manufacturer Identifier (3 or 6 characters).

Parameter	Type	Required	Description
query	string	Yes	WMI code (e.g. `1FT`, `JHM`)

type: `makes`

Search makes, models, and vehicle types.

Parameter	Type	Required	Description
search_type	string	Yes	`all`, `manufacturer`, `vehicletype`, `models`, `vehicletypes`
query	string	No*	Manufacturer/make/vehicle type (see search_type). *Required except for `all`.
year	int	No	Model year (for `manufacturer`, `models`)
vehicle_type	string	No	e.g. `Passenger Car`, `Truck` (for `models`)

type: `manufacturers`

Search manufacturers, WMIs, and parts documentation.

Parameter	Type	Required	Description
search_type	string	Yes	`all`, `details`, `wmis`, `parts`
query	string	No*	Manufacturer name or ID. *Required for `details`, `wmis`.
mfr_type	string	No	e.g. `Completed Vehicle Manufacturer` (for `all`)
from_date	string	No*	`YYYY-MM-DD`. *Required for `parts`.
to_date	string	No*	`YYYY-MM-DD`. *Required for `parts`.
parts_type	string	No	`565` or `566`. Default: `565`. (for `parts`)
vehicle_type	string	No	(for `wmis`)
page	int	No	Page number. Default: 1.

type: `variables`

Get the list of vehicle variables or values for a specific variable.

Parameter	Type	Required	Description
search_type	string	Yes	`list` (all variables) or `values` (values for one variable)
query	string	No*	Variable name (e.g. `Vehicle Type`, `Make`). *Required for `values`.

type: `canadian`

Get Canadian Vehicle Specifications (1971+). Uses year and make; query is not used.

Parameter	Type	Required	Description
year	int	Yes	Model year (1971+)
make	string	Yes	Make (e.g. `Honda`, `Toyota`)
model	string	No	Model name
units	string	No	`Metric` or `Imperial` (Imperial is sent as `US` to the API). Default: `Metric`.

Response

Returns JSON. Structure depends on type (object for decode/wmi, array for makes/manufacturers/variables/list, etc.).

Example: Decode VIN

curl "https://www.osintcat.net/api/vin?type=decode&query=1HGBH41JXMN109186&model_year=2021" \
     -H "X-API-KEY: YOUR_API_KEY"

import requests

url = "https://www.osintcat.net/api/vin"
params = {
    "type": "decode",
    "query": "1HGBH41JXMN109186",
    "model_year": "2021"
}
headers = {"X-API-KEY": "YOUR_API_KEY"}

response = requests.get(url, params=params, headers=headers)

if response.ok:
    print(response.json())
else:
    print(f"Error: {response.status_code} - {response.text}")

const params = new URLSearchParams({
  type: 'decode',
  query: '1HGBH41JXMN109186',
  model_year: '2021'
});

fetch(`https://www.osintcat.net/api/vin?${params}`, {
  headers: { 'X-API-KEY': 'YOUR_API_KEY' }
})
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error('error:', err));

Example: WMI Decode

curl "https://www.osintcat.net/api/vin?type=wmi&query=1FT" \
     -H "X-API-KEY: YOUR_API_KEY"

Example: Get All Makes

curl "https://www.osintcat.net/api/vin?type=makes&search_type=all&query=" \
     -H "X-API-KEY: YOUR_API_KEY"

Or with a dummy query (some clients omit empty query):

curl "https://www.osintcat.net/api/vin?type=makes&search_type=all" \
     -H "X-API-KEY: YOUR_API_KEY"

Example: Models by Make

curl "https://www.osintcat.net/api/vin?type=makes&search_type=models&query=Tesla&year=2023" \
     -H "X-API-KEY: YOUR_API_KEY"

Example: Variable List

curl "https://www.osintcat.net/api/vin?type=variables&search_type=list" \
     -H "X-API-KEY: YOUR_API_KEY"

Example: Variable Values

curl "https://www.osintcat.net/api/vin?type=variables&search_type=values&query=Vehicle%20Type" \
     -H "X-API-KEY: YOUR_API_KEY"

Example: Canadian Vehicle Specifications

curl "https://www.osintcat.net/api/vin?type=canadian&year=2022&make=Honda&model=Civic&units=Metric" \
     -H "X-API-KEY: YOUR_API_KEY"

Example: Batch Decode

# Send VINs as newline-separated in query (URL-encode newlines as %0A)
curl "https://www.osintcat.net/api/vin?type=batch&query=1HGBH41JXMN109186%0A5YJ3E1EA1KF123456" \
     -H "X-API-KEY: YOUR_API_KEY"

For batch, query can also be sent in the request body as form data or in a POST with a JSON body if your client supports it; the backend reads query from request.args.

Error Responses

Code	Description
400	Bad request: missing/invalid `query` (when required), invalid `type` or `search_type`, or validation error (e.g. `from_date`/`to_date` required for `parts`).
403	Invalid or missing `X-API-KEY`.
429	Rate limit exceeded.
500	vPIC or internal error.

Errors return JSON, e.g. {"error": "query parameter is required"}.

GTA Online Players

VIN Lookup

curl --request GET \
  --url https://www.osintcat.net/api/vin \
  --header 'X-API-KEY: <x-api-key>'

import requests

url = "https://www.osintcat.net/api/vin"

headers = {"X-API-KEY": "<x-api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-KEY': '<x-api-key>'}};

fetch('https://www.osintcat.net/api/vin', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.osintcat.net/api/vin",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.osintcat.net/api/vin"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://www.osintcat.net/api/vin")
  .header("X-API-KEY", "<x-api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.osintcat.net/api/vin")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

Overview

Account

OSINT Lookups

Network & Domain

Public Records

Vehicle

Gaming

Resolvers

Machine Viewer

FootPrint Intel

Headers

Parameters

type: `decode`

type: `batch`

type: `wmi`

type: `makes`

type: `manufacturers`

type: `variables`

type: `canadian`

Response

Example: Decode VIN

Example: WMI Decode

Example: Get All Makes

Example: Models by Make

Example: Variable List

Example: Variable Values

Example: Canadian Vehicle Specifications

Example: Batch Decode

Error Responses

​Headers

​Parameters

​type: decode

​type: batch

​type: wmi

​type: makes

​type: manufacturers

​type: variables

​type: canadian

​Response

​Example: Decode VIN

​Example: WMI Decode

​Example: Get All Makes

​Example: Models by Make

​Example: Variable List

​Example: Variable Values

​Example: Canadian Vehicle Specifications

​Example: Batch Decode

​Error Responses

Headers

Parameters

type: `decode`

type: `batch`

type: `wmi`

type: `makes`

type: `manufacturers`

type: `variables`

type: `canadian`

Response

Example: Decode VIN

Example: WMI Decode

Example: Get All Makes

Example: Models by Make

Example: Variable List

Example: Variable Values

Example: Canadian Vehicle Specifications

Example: Batch Decode

Error Responses