JOIN: recalls + complaints + NCAP ratings into one composite vehicle risk score API

Joins NHTSA recalls, owner complaints, and NCAP crash ratings for a make/model/year into ONE composite 0-100 risk score (complaint flags + recall volume + 'do-not-drive' park-it recalls minus star bonus), with a do-not-drive flag. The MORE: one call instead of three APIs. Answers 'how risky is a <year> <make> <model> overall?'.

Price$0.01per request

MethodPOST

Route/v1/gov/vehicle-safety-snapshot

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

govrecallsnhtsavehiclesafetyjoincomposite-riskautomotive-safety

API URLhttps://x402.hexl.dev/v1/gov/vehicle-safety-snapshot

Integration docs

Example request

{
  "make": "Jeep",
  "model": "Grand Cherokee",
  "modelYear": 2015
}

Example response

{
  "make": "Jeep",
  "model": "Grand Cherokee",
  "modelYear": "2015",
  "compositeRiskScore": 42,
  "compositeRiskClass": "moderate",
  "doNotDriveRecall": false,
  "recalls": {
    "count": 10,
    "items": [
      {
        "campaignNumber": "20V475000",
        "component": "ENGINE AND ENGINE COOLING:ENGINE:DIESEL",
        "consequence": "An engine stall can increase the risk of a crash.",
        "remedy": "FCA US will notify owners, and dealers will update the powertrain control module software to maintain vehicle propulsion by reading the camshaft position signal in the event that the crankshaft position signal is lost, free of charge.  Owner notification letters were mailed on May 13, 2021.  Owners may contact FCA US customer service at 1-800-853-2002.  FCA US's number for this recall is W58.",
        "date": "13/08/2020",
        "doNotDrive": false
      },
      {
        "campaignNumber": "18V332000",
        "component": "ELECTRICAL SYSTEM:WIRING",
        "consequence": "If the vehicle maintains its speed or accelerates despite attempts to deactivate the cruise control, there would be an increased risk of a crash.",
        "remedy": "Chrysler will notify owners, and dealers will inspect the software, and perform a software flash on the engine or powertrain control module, free of charge.  The recall began June 4, 2018.  Owners may contact Chrysler customer service at 1-800-853-1403.  Note: Owners are advised to stop using cruise control until the software update has been performed.  In the event that cruise control cannot be disengaged while driving, owners should firmly and steadily apply the brakes and shift the transmission to neutral, placing the vehicle in park once it has stopped.",
        "date": "17/05/2018",
        "doNotDrive": false
      }
    ]
  },
  "complaints": {
    "total": 1332,
    "crashes": 127,
    "fires": 21,
    "injuries": 91,
    "deaths": 0,
    "severityScore": 9,
    "severityClass": "low",
    "topComponents": [
      {
        "component": "POWER TRAIN",
        "count": 347
      },
      {
        "component": "SEATS",
        "count": 303
      },
      {
        "component": "ENGINE",
        "count": 196
      },
      {
        "component": "UNKNOWN OR OTHER",
        "count": 190
      },
      {
        "component": "ELECTRICAL SYSTEM",
        "count": 135
      }
    ]
  },
  "ncapRatings": {
    "rated": true,
    "averageOverallStars": 4.5,
    "variantCount": 2
  }
}

Input schema

{
  "type": "object",
  "required": [
    "make",
    "model",
    "modelYear"
  ],
  "properties": {
    "make": {
      "type": "string"
    },
    "model": {
      "type": "string"
    },
    "modelYear": {
      "type": [
        "string",
        "number"
      ],
      "description": "4-digit year."
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}