Enhanced VIN Decoder

Third-party VIN decoder service powered by EpiAnalytics providing comprehensive vehicle specifications and data.

The Enhanced VIN Decoder API integrates with EpiAnalytics to provide comprehensive vehicle specifications from valid 17-character VINs. This service delivers detailed vehicle information through third-party data services, offering enhanced decoding capabilities beyond basic VIN validation.

Base Path

GET https://api.marketcheck.com/v2/decode/car/epi/{vin}/specs

Path Parameters:

  • vin: The 17-character VIN of the vehicle to decode using EpiAnalytics.

The following example demonstrates a basic request to the Enhanced VIN Decoder API:

request.js
import axios from 'axios';

const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/decode/car/epi/1FAHP3F28CL148530/specs',
params: {api_key: 'YOUR_API_KEY'},
headers: {Accept: 'application/json'}
};

try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}

Request

This endpoint delivers detailed vehicle information through third-party data services for enhanced decoding capabilities.

Parameters

Available parameters for enhanced VIN decoding requests:

1 Params
api_key
string required

Your MarketCheck API authentication key. Required for every request, unless OAuth is used.

Required Parameters

The following parameters are required for enhanced VIN decoding requests:

  • vin - The 17-character VIN of the vehicle to decode (provided in URL path)
    • Case-insensitive string that must be properly formatted
    • Must be provided as a path parameter in the URL structure
    • Example: 1HGCM82633A123456

Response

The Enhanced VIN Decoder API returns comprehensive vehicle specifications derived from EpiAnalytics integration in a structured JSON format.

Success Response

  • 200 OK - Returns a JSON object containing enhanced vehicle specifications
    • Includes comprehensive details from EpiAnalytics integration
    • Contains enhanced data beyond basic VIN decoding
    • Provides detailed vehicle specifications and market information

Error Response

Status CodeDescriptionCommon Causes
400Bad RequestInvalid VIN format or missing parameters
401UnauthorizedMissing/invalid API key
403ForbiddenAPI key does not have access to this endpoint
422Unprocessable EntityInvalid VIN or EpiAnalytics decoding failed
429Too Many RequestsRate limit exceeded
500Internal Server ErrorTemporary server issues
502Bad GatewayIssues with upstream services
503Service UnavailableAPI maintenance or downtime

Error Response Format

Most error responses follow this structure, except for 502 and 503 errors

{
  "code": <HTTP status code>,
  "message": "<Error message describing the issue>"
}

Use Cases & Examples

Enhanced Vehicle Specifications

Access richer vehicle data through our EpiAnalytics partnership—beyond basic VIN decoding.

Example:

Here we're performing enhanced VIN decoding for detailed specifications:

request.js
import axios from 'axios';

const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/decode/car/epi/1FAHP3F28CL148530/specs',
params: {api_key: 'YOUR_API_KEY'},
headers: {Accept: 'application/json'}
};

try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}

See Also