Name: VIN Decoder API: Decode VINs for Vehicle Specs & History
Brand: torquenode
SKU: api-torquenode-vin-decoding
Availability: InStock
Author: API Market

# VIN Decoding API | Instant Vehicle Information & Specifications

## Overview

The VIN Decoding API provides instant access to comprehensive vehicle information by decoding Vehicle Identification Numbers (VINs).  Retrieve detailed specifications, engine details, drivetrain information, and manufacturing data for virtually any vehicle. This API streamlines access to vehicle data, eliminating the need for manual lookups and complex databases.



## Features

*   **Instant VIN Decoding:** Get vehicle information in seconds.
*   **Detailed Vehicle Specifications:** Access year, make, model, trim, vehicle type, and more.
*   **Engine Information:** Retrieve engine model, cylinders, fuel type, and engine size.
*   **Drivetrain Details:**  Access drivetrain type and transmission information.
*   **Manufacturing Data:** Get manufacturer details, assembly plant location, and country of origin.
*   **Comprehensive Identifiers:** Retrieve WMI, VDS, and VIS identifiers.

## Use Cases

*   **Automotive Applications:** Integrate VIN decoding into automotive apps for vehicle identification, parts lookup, and service recommendations.
*   **Dealership Inventory Management:**  Quickly populate vehicle details for online listings, inventory management systems, and customer interactions.
*   **Insurance Claims Processing:** Verify vehicle specifications and identify potential discrepancies during insurance claims processing to ensure accurate assessments.
*   **Fleet Management Platforms:** Automate vehicle data entry for fleet tracking, maintenance scheduling, and compliance reporting.
*   **Vehicle History Reports:**  Enhance vehicle history reports with detailed specifications retrieved from VINs.

## Visual Examples

**Output Example:**

Here's an example of the JSON data returned by the API for a VIN:

```json
{
  "status": "success",
  "data": {
    "vin": "1FMSK8DH9LGC95835",
    "vehicle": {
      "year": "2020",
      "make": "Ford",
      "model": "Explorer",
      "trim": "XLT",
      "vehicle_type": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
      "vehicle_category": "Passenger Car",
      "body_style": "Sport Utility Vehicle (SUV)/Multi-Purpose Vehicle (MPV)",
      "doors": "4"
    },
    "identifiers": {
      "wmi": "1FM",
      "vds": "SK8DH9",
      "vis": "LGC95835"
    },
    "engine": {
      "model": "",
      "cylinders": "4",
      "fuel_type": "Gasoline",
      "engine_size_l": "2.3",
      "engine_size_cc": "2300.0"
    },
    "drivetrain": {
      "type": "4WD/4-Wheel Drive/4x4",
      "transmission": "Automatic"
    },
    "manufacturing": {
      "manufacturer": "FORD MOTOR COMPANY",
      "company": "Chicago Assembly",
      "city": "Chicago",
      "state": "Illinois",
      "country": "United States (Usa)"
    }
  }
}
```


## API Documentation

https://torquenode.com/doc/vin-decoder

### Base URL

All API requests should be made to: `https://prod.api.market/api/v1/torquenode/vin-decoding`

### Authentication

Authentication is handled via API key. Include your API key in the request header:

```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Endpoints

#### Decode VIN

`GET /vin-decoder`

Returns detailed vehicle information based on a VIN number.

**Parameters:**

*   `vin` (query, required): The Vehicle Identification Number to decode. Example: `1FMSK8DH9LGC95835`

**Request Example:**

```bash
curl -X GET "https://prod.api.market/api/v1/torquenode/vin-decoding/vin-decoder?vin=1FMSK8DH9LGC95835" \
-H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Response Example (200 OK):**

```json
{
  "status": "success",
  "data": {
    "vin": "1FMSK8DH9LGC95835",
    "vehicle": {
      "year": "2020",
      "make": "Ford",
      "model": "Explorer",
      "trim": "XLT",
      "vehicle_type": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
      "vehicle_category": "Passenger Car",
      "body_style": "Sport Utility Vehicle (SUV)/Multi-Purpose Vehicle (MPV)",
      "doors": "4"
    },
    "identifiers": {
      "wmi": "1FM",
      "vds": "SK8DH9",
      "vis": "LGC95835"
    },
    "engine": {
      "model": "",
      "cylinders": "4",
      "fuel_type": "Gasoline",
      "engine_size_l": "2.3",
      "engine_size_cc": "2300.0"
    },
    "drivetrain": {
      "type": "4WD/4-Wheel Drive/4x4",
      "transmission": "Automatic"
    },
    "manufacturing": {
      "manufacturer": "FORD MOTOR COMPANY",
      "company": "Chicago Assembly",
      "city": "Chicago",
      "state": "Illinois",
      "country": "United States (Usa)"
    }
  }
}
```

**Response Examples (Error):**

*   **400 Bad Request:** Invalid VIN or request parameters

    ```json
    {
      "error": "Invalid VIN format"
    }
    ```

*   **401 Unauthorized:** Invalid API key

    ```json
    {
      "error": "Invalid API key"
    }
    ```

*   **404 Not Found:** VIN not found

    ```json
    {
      "error": "VIN not found in database"
    }
    ```

*   **500 Internal Server Error:** Internal server error

    ```json
    {
      "error": "Internal server error"
    }
    ```

## Status Codes

*   200 OK: Request successful and VIN decoded.
*   400 Bad Request: Invalid VIN format or missing required parameters. Check the VIN format and ensure all required parameters are included.
*   401 Unauthorized: Missing or invalid API key. Verify your API key is correctly included in the request header.
*   404 Not Found: The provided VIN was not found in the database. Ensure the VIN is correct.
*   500 Internal Server Error: An unexpected error occurred on the server. Retry the request later. If the problem persists, contact support.

## Rate Limits

Please contact us for information about the rate limits.

## Error Handling

The API returns standard HTTP status codes to indicate the success or failure of a request.  Error responses are typically in JSON format, providing details about the error.

**Example Error Response:**

```json
{
  "error": {
    "code": "invalid_vin",
    "message": "The VIN provided is not valid.",
    "status": 400
  }
}
```

**Best Practices:**

*   Always check the HTTP status code of the response.
*   If the status code indicates an error (4xx or 5xx), examine the JSON response for details about the error.
*   Implement error handling logic in your code to gracefully handle errors and provide informative messages to the user.
*   For transient errors (e.g., 500 Internal Server Error), consider implementing a retry mechanism with exponential backoff.

## Implementation Guide

This guide provides example code for using the VIN Decoding API.

### Example Code

```python
import requests

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/torquenode/vin-decoding"

def decode_vin(vin):
    headers = {
        "x-api-market-key": API_KEY
    }
    params = {
        "vin": vin
    }
    response = requests.get(f"{BASE_URL}/vin-decoder", headers=headers, params=params)
    if response.status_code == 200:
        return response.json()
    else:
        print(f"Error: {response.status_code} - {response.text}")
        return None

# Example usage
vin_to_decode = "1FMSK8DH9LGC95835"
result = decode_vin(vin_to_decode)

if result:
    print(result)
```

```javascript
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/torquenode/vin-decoding";

async function decodeVin(vin) {
  try {
    const url = `${baseUrl}/vin-decoder?vin=${vin}`;

    const response = await fetch(url, {
      method: 'GET',
      headers: {
        'x-api-market-key': apiKey
      }
    });

    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }

    const data = await response.json();
    return data;
  } catch (error) {
    console.error("There was an error!", error);
    return null;
  }
}

// Example usage
const vinToDecode = "1FMSK8DH9LGC95835";
decodeVin(vinToDecode)
  .then(result => {
    if (result) {
      console.log(result);
    }
  });
```

```bash
curl -X GET "https://prod.api.market/api/v1/torquenode/vin-decoding/vin-decoder?vin=1FMSK8DH9LGC95835" \
-H "x-api-market-key: YOUR_API_MARKET_KEY"
```

### Performance Optimization

*   Cache frequently accessed VIN data to reduce API calls.
*   Implement proper error handling and retry mechanisms to handle transient errors.

## FAQ

**Q: What type of vehicles can be decoded with this API?**

A: The API supports decoding VINs for most passenger vehicles, trucks, and SUVs manufactured for the North American market.

**Q: What if the API cannot decode a specific VIN?**

A: The API may not be able to decode VINs for very old vehicles, vehicles manufactured outside of North America, or VINs that are invalid or corrupted.

**Q: How often is the VIN database updated?**

A: The VIN database is regularly updated to ensure accuracy and completeness.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to support@torquenode.com


Unlock vehicle details with our VIN Decoder API. Get specs, history, manufacturing info. Fast, accurate vehicle data from any VIN.

VIN Decoder API: Decode VINs for Vehicle Specs & History

Free

TorqueNode