v1

latestOpenAPI 3.1.0Proprietary2026-08-061935150.4 KB

Recalls

Look up recall records

Look up U.S. recall records for a given make / model / year. Acts as a normalising proxy in front of the upstream recall database. Results are cached server-side so repeated lookups for the same combination do not re-hit the upstream.

get/recalls

Query parameters

makestring required

Example:TOYOTA

Vehicle manufacturer (case-insensitive)

modelstring required

Example:RAV4

Vehicle model (case-insensitive)

modelYearstring required

Example:2020

4-digit model year as a string

Response

Recall lookup result

countinteger required

Number of recall records (upstream-reported, falls back to recalls.length)

hasRecallsboolean required

True when at least one recall was found

Example response

{
  "count": 2,
  "hasRecalls": true,
  "recalls": [
    {
      "manufacturer": "Toyota Motor Engineering & Manufacturing",
      "reportReceivedDate": "23/01/2020",
      "component": "FUEL SYSTEM, GASOLINE",
      "modelYear": "2020",
      "make": "TOYOTA",
      "model": "RAV4"
    }
  ]
}