apyhub
Back
▣ RETRIEVAL KIT · VERIFICATION KIT

Decode VIN & Check US Vehicle Recalls API

What it does

Vehicle Recall Decoder checks one or more VINs, or plain vehicle descriptions, and returns decoded vehicle rows from NHTSA. You can send up to 50 VINs per run, or up to 20 vehicle descriptions when you do not have a VIN.

Use includeRecalls when you want each decoded VIN or vehicle to come back with recall data attached. When that flag is off, you get just the decoded specs; when it is on, the response includes recall-related details for each returned row. Malformed VINs are marked with invalid_format and are not sent upstream.

This is useful when you need to verify a customer-entered VIN during onboarding, enrich a vehicle record in your CRM, or check whether a listed car has open recalls before showing it in a marketplace or service workflow.

The response includes billed, count, and an items array of result rows, so you can track usage and process each vehicle independently.

POST
Vehicle Recalls & VIN Decoder API - Car Specs, NHTSA
https://api.eu.apyhub.com/martin10291/vehicle-recalls-vin-decoder

QUICKSTART

GUIDE

Quickstart

Decode one or more VINs and optionally include recall data in a single POST request.

curl -X POST "https://api.eu.apyhub.com/martin10291/vehicle-recalls-vin-decoder" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "vins": ["1HGCV1F35KA000001"],
  }'

What you'll get back

Returns a JSON object with billed and count integer fields, plus an items array of objects.

{
  "billed": 1,
  "count": 1,
  "items": [
    {
      "bodyClass": "Sedan/Saloon",
      "checkDigitValid": true,
      "checkedAt": "2026-11-17T08:18:26Z",
      "decodeNote": null,
      "doors": 4,
      "driveType": "4x2",
      "engine": {
        "configuration": "In-Line",
        "cylinders": 4,
        "displacementL": 1.5,
        "fuelType": "Gasoline",
        "hp": 192
      },
      "error": null,
      "gvwr": "Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)",
      "make": "HONDA",
      "manufacturer": "AMERICAN HONDA MOTOR CO., INC.",
      "model": "Accord",
      "modelYear": 2019,
      "plantCity": "MARYSVILLE",
      "plantCountry": "UNITED STATES (USA)",
      "plantState": "OHIO",
      "recallCount": null,
      "recalls": null,
      "safety": {
        "abs": "Standard",
        "airbagsCurtain": "All Rows",
        "airbagsFront": "1st Row (Driver and Passenger)",
        "airbagsKnee": "1st Row (Driver and Passenger)",
        "airbagsSide": "1st Row (Driver and Passenger)",
        "automaticEmergencyBraking": null,
        "esc": "Standard",
        "forwardCollisionWarning": "Standard",
        "laneDepartureWarning": "Standard",
        "tpms": "Indirect"
      },
      "source": "NHTSA vPIC + NHTSA Recalls API (US market vehicles)",
      "status": "ok",
      "transmission": "Continuously Variable Transmission (CVT)",
      "trim": "Sport",
      "type": "vehicle",
      "vehicleType": "PASSENGER CAR",
      "vin": "1HGCV1F35KA000001"
    }
  ]
}
TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body
vins
Vehicle identification numbers (17 characters, no letters I, O, Q), up to 50 per run. A malformed VIN returns a row with status invalid_format and is not sent upstream. VINs of US market vehicles decode best.
vehicles
Optional. Vehicles to check for recalls without a VIN, up to 20 per run. Each entry is a text like 2019 honda accord (year, one-word make, model) or an object {"year": 2019, "make": "land rover", "model": "range rover"} for makes with several words.
If on, every decoded VIN or vehicle gets its NHTSA recalls attached (recallCount and the recalls list). Turn off to get only the decoded specs. Always on in Only new recalls mode.

About this endpoint

What it does

Decodes up to 50 VINs and/or checks up to 20 vehicles for recalls in one call. When enabled, the response includes recall data alongside the decoded specs for each result row.

Request Body

ParameterTypeMandatoryDescription
vinsString ArrayNoVehicle identification numbers, 17 characters each, with no letters I, O, or Q. Up to 50 per run. A malformed VIN returns a row with status invalid_format and is not sent upstream. VINs of US market vehicles decode best.
vehiclesString ArrayNoOptional vehicles to check for recalls without a VIN, up to 20 per run. Each entry can be a text value like 2019 honda accord or an object like {"year": 2019, "make": "land rover", "model": "range rover"} for makes with several words.
includeRecallsBooleanNoIf true, every decoded VIN or vehicle includes NHTSA recalls attached (recallCount and the recalls list). Turn off to get only the decoded specs. Always on in Only new recalls mode.

Response

Returns a JSON object with three top-level fields: billed (integer), count (integer), and items (array). billed is the number of units charged for the call, count is the number of rows in items, and items contains the result rows.

ParameterTypeMandatoryDescription
billedIntegerYesUnits charged for this call: result rows only; not-found / unavailable / invalid rows are free.
countIntegerYesNumber of rows in items.
itemsObject ArrayYesResult rows returned by the endpoint.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.