RecallScout

Decode a US 17-character VIN and return the vehicle's year, make, model, trim, engine and standard safety features, plus all NHTSA safety recalls for that make/model/year, an owner-complaint summary and NHTSA crash-test star ratings. Use when the user shares a VIN or asks about a specific car they own or plan to buy. Recalls are matched by make/model/year, not per VIN repair status.

{
  "type": "object",
  "properties": {
    "vin": {
      "type": "string",
      "minLength": 11,
      "maxLength": 25,
      "description": "The 17-character Vehicle Identification Number"
    }
  },
  "required": [
    "vin"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List NHTSA safety recalls for a vehicle by make, model and model year, newest first, with the defect summary, safety risk, remedy and whether NHTSA advises not driving or parking outside. Use when the user names a car (not a VIN) and asks about recalls or known safety defects.

{
  "type": "object",
  "properties": {
    "make": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "description": "Manufacturer, e.g. Honda, Ford, Tesla"
    },
    "model": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Model name as sold in the US, e.g. Accord, F-150, Model 3"
    },
    "model_year": {
      "type": "integer",
      "minimum": 1950,
      "maximum": 2030,
      "description": "Four-digit model year, e.g. 2020"
    }
  },
  "required": [
    "make",
    "model",
    "model_year"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Summarize complaints that owners filed with NHTSA for a vehicle by make, model and model year: total count, crashes, fires, injuries, the most-reported problem areas and the most recent complaint excerpts. Use when the user asks about common problems, reliability issues or what owners report about a car. Complaints are unverified owner reports, not confirmed defects.

{
  "type": "object",
  "properties": {
    "make": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "description": "Manufacturer, e.g. Honda, Ford, Tesla"
    },
    "model": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Model name as sold in the US, e.g. Accord, F-150, Model 3"
    },
    "model_year": {
      "type": "integer",
      "minimum": 1950,
      "maximum": 2030,
      "description": "Four-digit model year, e.g. 2020"
    },
    "recent_limit": {
      "default": 5,
      "description": "How many recent complaint excerpts to include (0-10)",
      "type": "integer",
      "minimum": 0,
      "maximum": 10
    }
  },
  "required": [
    "make",
    "model",
    "model_year"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get NHTSA 5-Star Safety Ratings (overall, frontal crash, side crash, rollover and rollover risk) for each tested variant of a vehicle by make, model and model year. Use when the user asks how safe a car is or wants to compare crash-test results. Many low-volume vehicles are never tested.

{
  "type": "object",
  "properties": {
    "make": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "description": "Manufacturer, e.g. Honda, Ford, Tesla"
    },
    "model": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Model name as sold in the US, e.g. Accord, F-150, Model 3"
    },
    "model_year": {
      "type": "integer",
      "minimum": 1950,
      "maximum": 2030,
      "description": "Four-digit model year, e.g. 2020"
    }
  },
  "required": [
    "make",
    "model",
    "model_year"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Look up one NHTSA recall by its campaign number (for example 20V771000, often printed on a recall letter) and return the defect, safety risk, remedy, manufacturer notes and the affected vehicles. Use when the user has a recall notice or campaign number.

{
  "type": "object",
  "properties": {
    "campaign_number": {
      "type": "string",
      "minLength": 9,
      "maxLength": 14,
      "description": "NHTSA campaign number, e.g. 20V771000"
    }
  },
  "required": [
    "campaign_number"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search NHTSA safety recalls for child car seats and boosters (2010 onward) by brand and/or model, newest first. Returns each recall's affected models, manufacturing date window, defect, risk and free remedy. Use when the user asks whether a car seat, infant seat or booster is recalled. Owners should compare the manufacture date and model number on their seat's label with the window returned.

{
  "type": "object",
  "properties": {
    "brand": {
      "description": "Car seat brand, e.g. Graco, Britax, Evenflo, Chicco",
      "type": "string",
      "minLength": 2,
      "maxLength": 40
    },
    "model": {
      "description": "Model name or part of it, e.g. 4Ever, Revolve 180, KeyFit",
      "type": "string",
      "minLength": 2,
      "maxLength": 80
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search US Consumer Product Safety Commission (CPSC) recalls by product, brand or hazard keyword (for example crib, stroller, space heater, magnets, or a brand name), newest first. Returns the hazard, remedy, injuries reported, where it was sold, the company's recall contact and the official recall page. Use for household, children's and consumer products. Not for vehicles, car seats, food or medicines.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "Product type, brand or hazard keyword"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search US FDA food recall enforcement reports, newest first, optionally by product, ingredient, allergen or company (for example peanut butter, listeria, cucumbers or a brand). Leave the query empty to list the latest food recalls. Returns the product, reason, lot codes, the states or regions it was distributed to, and the FDA severity class. Covers FDA-regulated foods only; meat, poultry and egg products are recalled by the USDA and aren't included. FDA publishes reports weekly, so the newest recalls can take a few days to appear.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Product, ingredient, allergen or company. Omit for the latest recalls.",
      "type": "string",
      "maxLength": 80
    },
    "days": {
      "default": 180,
      "description": "How far back to search, in days (default 180)",
      "type": "integer",
      "minimum": 7,
      "maximum": 1095
    },
    "ongoing_only": {
      "default": false,
      "description": "Only include recalls FDA still lists as ongoing",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}