NHTSA vehicle VIN decoder

Endpoint

https://apiacre.com/v1/data/vin-decode

Send the JSON body below. An unpaid request returns HTTP 402 with a PAYMENT-REQUIRED header; an x402-compatible buyer signs the requirement and retries with PAYMENT-SIGNATURE.

Agent one-call path

Optional third-party AgentCash can inspect this route and handle the x402 retry. Its fetch command may automatically pay, so this example caps the call at exactly $0.003 USDC. Copying the command does not pay; review the local wallet and request before running it.

npx --yes agentcash@latest check https://apiacre.com/v1/data/vin-decode
npx --yes agentcash@latest fetch https://apiacre.com/v1/data/vin-decode \
  --method POST \
  --header 'content-type: application/json' \
  --body '{"vin":"1HGCM82633A004352","model_year":2003}' \
  --payment-protocol x402 \
  --payment-network base \
  --max-amount 0.003

AgentCash CLI documentation · Official SDK and wallet-safety alternatives

Input example

{
  "vin": "1HGCM82633A004352",
  "model_year": 2003
}

Response shape

View free static sample JSON

{
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "data.vin-decode",
  "version": "1",
  "data": {
    "vin": "1HGCM82633A004352",
    "modelYearHint": 2003,
    "decode": {
      "status": "clean",
      "clean": true,
      "errorCodes": [
        0
      ],
      "errorText": "0 - VIN decoded clean. Check Digit (9th position) is correct",
      "apiMessage": "Results returned successfully. NOTE: Any missing decoded values should be interpreted as NHTSA does not have data on the specific variable. Missing value should NOT be interpreted as an indication that a feature or technology is unavailable for a vehicle."
    },
    "decodedFieldCount": 20,
    "missingFields": [
      "series",
      "driveType",
      "fuelTypeSecondary",
      "electrificationLevel",
      "engine.manufacturer",
      "plant.companyName",
      "occupancy.seats",
      "occupancy.seatRows"
    ],
    "vehicle": {
      "make": "HONDA",
      "model": "Accord",
      "modelYear": 2003,
      "manufacturer": "AMERICAN HONDA MOTOR CO., INC.",
      "manufacturerId": 988,
      "vehicleType": "PASSENGER CAR",
      "bodyClass": "Coupe",
      "series": null,
      "trim": "EX-V6",
      "doors": 2,
      "driveType": null,
      "fuelTypePrimary": "Gasoline",
      "fuelTypeSecondary": null,
      "electrificationLevel": null,
      "engine": {
        "cylinders": 6,
        "displacementLiters": 2.998832712,
        "horsepower": 240,
        "model": "J30A4",
        "manufacturer": null
      },
      "transmission": {
        "style": "Automatic",
        "speeds": 5
      },
      "plant": {
        "city": "MARYSVILLE",
        "state": "OHIO",
        "country": "UNITED STATES (USA)",
        "companyName": null
      },
      "occupancy": {
        "seats": null,
        "seatRows": null,
        "grossVehicleWeightRating": "Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)"
      }
    },
    "source": {
      "provider": "National Highway Traffic Safety Administration",
      "dataset": "vPIC",
      "endpointUrl": "https://vpic.nhtsa.dot.gov/api/vehicles/DecodeVinValuesExtended/1HGCM82633A004352?format=json&modelyear=2003",
      "documentationUrl": "https://vpic.nhtsa.dot.gov/api/",
      "attribution": "NHTSA Product Information Catalog and Vehicle Listing (vPIC).",
      "rateControlNotice": "NHTSA applies automated traffic rate controls; API Acre caches results and does not bypass those controls."
    },
    "retrievedAt": "2026-08-12T01:30:00+00:00",
    "limitations": [
      "Missing decoded values mean NHTSA has no data for that variable, not that a feature is absent.",
      "A decode does not establish ownership, title, registration, accident, theft, recall, or vehicle-condition status.",
      "VINs can be linkable vehicle identifiers; do not use this result to identify or profile a person."
    ]
  },
  "meta": {
    "duration_ms": 42,
    "cached": false,
    "sources": [],
    "warnings": [],
    "next_actions": []
  }
}

Try the payment challenge

curl -i -X POST 'https://apiacre.com/v1/data/vin-decode' \
  -H 'content-type: application/json' \
  --data '{"vin":"1HGCM82633A004352","model_year":2003}'