AutoRecalls

Retrieve vehicle recall information by VIN from AutoRecalls partnership data.

The AutoRecalls API provides detailed recall information for any vehicle using a valid 17-character VIN. This service leverages the AutoRecalls SuperCheck API to deliver critical safety data, open and closed recalls, safety and emission issues, and OEM service campaigns (when available).

This API is particularly valuable for automotive professionals, dealers, and consumers who need to verify recall status and obtain detailed recall information for specific vehicles, helping to ensure vehicle safety and regulatory compliance.

Users must accept the terms and conditions on the Universe Portal to access these endpoints. Check the Terms and Conditions for more information.

Base Path

GET https://api.marketcheck.com/v2/car/autorecalls/{vin}

Path Parameters:

vin: The 17-character VIN of the vehicle to check for recalls.

The following example demonstrates a basic request to the AutoRecalls API:

request.js

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/car/autorecalls/1FAHP3F28CL148530',
  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

The AutoRecalls API provides access to comprehensive recall information using a valid 17-character Vehicle Identification Number (VIN). This endpoint leverages the AutoRecalls SuperCheck service to retrieve detailed recall data, including both open and closed recall status, safety and emission recalls, and OEM service campaigns when available.

Parameters

Available parameters for recall lookup 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 recall lookup requests:

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

Use Cases & Examples

Vehicle Recall Check

Use the AutoRecalls SuperCheck API to verify critical safety information for specific vehicles. This service addresses one of the most important data elements in the automotive industry - identifying whether a vehicle has open recalls affecting consumer safety. The API helps increase consumer participation in automotive recalls by providing transparent access to recall status.

Example:

Here we're checking for recalls on a specific VIN:

request.js

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/car/autorecalls/4T1L11AK0LU891349',
  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);
}

Response

The AutoRecalls API returns comprehensive recall information for the specified vehicle in a structured JSON format.

Schema

interface AutoRecallsResponse {
  apiVersion: string; // API version identifier
  requestDate: string; // ISO timestamp of the request
  responseDate: string; // ISO timestamp of the response
  data: {
    itemsEffected: number; // Number of items affected
    totalItems: number; // Total number of items
    currentItemCount: number; // Current count of items in response
    items: {
      vehicle: {
        vin: string; // Vehicle Identification Number
        year: number; // Model year
        make: string; // Vehicle manufacturer
        model: string; // Vehicle model
        dataRefreshDate: string; // ISO timestamp of data refresh
        numberOfRecalls: number; // Total number of recalls for vehicle
        recallsAvailable: boolean; // Whether recalls are available
        dealerCode: string; // Dealer code
        oemCode: string; // Original Equipment Manufacturer code
        oemDescription: string; // OEM description
        errorReasonCode: string; // Error reason code if applicable
      };
      recalls: {
        oemRecallNumber: string; // OEM recall identifier
        status: string; // Recall status
        recallState: string; // State of the recall
        recallType: string; // Type of recall
        isExcluded: boolean; // Whether recall is excluded
        isApproved: boolean; // Whether recall is approved
        nhtsaNumber: string; // NHTSA campaign number
        severityCode: string; // Severity classification
        recallIssueDate: string; // Date recall was issued
        recallRefreshDate: string; // Date recall data was refreshed
        recallTitle: string; // Brief recall title
        recallDescription: string; // Detailed recall description
        riskDescription: string; // Description of risk
        remedyDescription: string; // Description of remedy
        notAvailableReason: string; // Reason if not available
        oemCode: string; // OEM code
        oemDescription: string; // OEM description
        recallPartsCost: number; // Cost of parts for recall
        recallLaborHours: number; // Labor hours required
        filterReason: string; // Reason for filtering
      }[]; // Array of recall information
      filteredRecalls: {
        // Same structure as recalls array above
      }[]; // Array of filtered recalls
    }[]; // Array of vehicle items
  };
  error: {
    code: number; // Error code
    message: string; // Error message
  };
}

Success Response

200 OK - Returns a JSON object containing comprehensive recall information for the VIN
- Includes both open and closed recall status from AutoRecalls SuperCheck
- Contains safety recalls, emission recalls, and OEM service campaigns
- Provides detailed recall descriptions and remedy information to support consumer safety

Error Response

Status Code	Description	Common Causes
400	Bad Request	Invalid VIN format or missing parameters
401	Unauthorized	Missing/invalid API key
403	Forbidden	API key does not have access to this endpoint
422	Unprocessable Entity	VIN not found or recall data unavailable
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Temporary server issues
502	Bad Gateway	Issues with upstream services
503	Service Unavailable	API 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>"
}