{
  "info": {
    "name": "RecallDB API",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "description": "Recall data from NHTSA, CPSC, FDA and USDA FSIS. Get a free key at https://recalldb.app/signup, set the collection variable apiKey, and show \"Data from RecallDB\" with a link to https://recalldb.app wherever you display the data."
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://recalldb.app"
    },
    {
      "key": "apiKey",
      "value": ""
    }
  ],
  "item": [
    {
      "name": "getRecall: Get a recall",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/recalls/:id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "recalls",
            ":id"
          ],
          "variable": [
            {
              "key": "id",
              "value": "",
              "description": "NHTSA campaign number, cpsc-<number> or fda-<event number>. Not case sensitive."
            }
          ],
          "query": []
        },
        "description": "Get a recall"
      }
    },
    {
      "name": "getVehicleRecalls: Recalls for a vehicle",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/vehicles/:make/:model/:year",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "vehicles",
            ":make",
            ":model",
            ":year"
          ],
          "variable": [
            {
              "key": "make",
              "value": "",
              "description": "Lowercase make name as on checkrecalls.org (honda, mercedes-benz, land-rover)."
            },
            {
              "key": "model",
              "value": "",
              "description": "Lowercase model name (civic, f-150, cx-5)."
            },
            {
              "key": "year",
              "value": "",
              "description": "Model year, any year NHTSA lists (for example 2019)."
            }
          ],
          "query": []
        },
        "description": "Recalls for a vehicle"
      }
    },
    {
      "name": "getRecallHistory: Recall change history",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/recalls/:id/history",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "recalls",
            ":id",
            "history"
          ],
          "variable": [
            {
              "key": "id",
              "value": "",
              "description": "The recall id, as in /v1/recalls/{id}."
            }
          ],
          "query": []
        },
        "description": "Recall change history"
      }
    },
    {
      "name": "searchRecalls: Search recalls",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/search",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "search"
          ],
          "variable": [],
          "query": [
            {
              "key": "q",
              "value": "",
              "description": "What to search for: at least 2 letters or numbers, at most 100 characters. Letters and numbers only are used.",
              "disabled": false
            },
            {
              "key": "category",
              "value": "",
              "description": "vehicle, motorcycle, rv, car_seat, tire, equipment, consumer_product, food, dietary_supplement, drug, medical_device, ca_vehicle, ca_product, ca_food, uk_food, au_product, eu_product, uk_product, uk_medicine, meat_poultry or public_health_alert.",
              "disabled": true
            },
            {
              "key": "agency",
              "value": "",
              "description": "nhtsa, cpsc, fda, usda, tc, hc, cfia or fsa.",
              "disabled": true
            },
            {
              "key": "fuzzy",
              "value": "",
              "description": "true (default) or false. When nothing matches, names (makes, models, brands, companies, product and food names) are tried with a corrected spelling, for example toyta becomes toyota, and meta.corrected_query says what was searched. Recall numbers, UPCs, model numbers, VINs and anything with a digit are always exact. fuzzy=false turns the correction off.",
              "disabled": true
            },
            {
              "key": "state",
              "value": "",
              "description": "A U.S. state code such as TX. Keeps recalls sold nationwide, in that state, or with no clear distribution. A recall is only dropped when its notice clearly lists other states and not this one.",
              "disabled": true
            },
            {
              "key": "from",
              "value": "",
              "description": "Only recalls dated on or after this day (YYYY-MM-DD, as the agency dates them).",
              "disabled": true
            },
            {
              "key": "to",
              "value": "",
              "description": "Only recalls dated on or before this day.",
              "disabled": true
            },
            {
              "key": "page",
              "value": "",
              "description": "Page number, 1 to 20 (default 1).",
              "disabled": true
            },
            {
              "key": "per_page",
              "value": "",
              "description": "Results per page, 1 to 50 (default 20).",
              "disabled": true
            }
          ]
        },
        "description": "Search recalls"
      }
    },
    {
      "name": "getBarcode: Look up a barcode",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/barcode/:code",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "barcode",
            ":code"
          ],
          "variable": [
            {
              "key": "code",
              "value": "",
              "description": "A barcode number, 8, 12, 13 or 14 digits. Spaces and dashes are ignored."
            }
          ],
          "query": []
        },
        "description": "Look up a barcode"
      }
    },
    {
      "name": "listNewRecalls: New recalls feed",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/new",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "new"
          ],
          "variable": [],
          "query": [
            {
              "key": "since",
              "value": "",
              "description": "A date or time, like 2026-11-01 or 2026-11-01T12:00:00Z. Default: 7 days ago. Older than 30 days is treated as 30 days.",
              "disabled": true
            },
            {
              "key": "category",
              "value": "",
              "description": "Only this category, as in /v1/search (vehicle, consumer_product, food, drug, and so on).",
              "disabled": true
            },
            {
              "key": "agency",
              "value": "",
              "description": "Only this agency: nhtsa, cpsc, fda, usda, tc, hc, cfia, fsa, accc, eusg, opss or mhra.",
              "disabled": true
            },
            {
              "key": "limit",
              "value": "",
              "description": "How many, 1 to 50 (default 20).",
              "disabled": true
            }
          ]
        },
        "description": "New recalls feed"
      }
    },
    {
      "name": "getCompany: Recalls by company",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/companies/:id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "companies",
            ":id"
          ],
          "variable": [
            {
              "key": "id",
              "value": "",
              "description": "The company id from its checkrecalls.org address."
            }
          ],
          "query": []
        },
        "description": "Recalls by company"
      }
    },
    {
      "name": "checkVinsBatch: Check many VINs",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/vins/batch",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "vins",
            "batch"
          ],
          "variable": [],
          "query": []
        },
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "description": "Check many VINs"
      }
    },
    {
      "name": "decodeVin: Decode a VIN",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/vin",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "vin"
          ],
          "variable": [],
          "query": []
        },
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "description": "Decode a VIN"
      }
    },
    {
      "name": "getUsage: Your usage",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/usage",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "usage"
          ],
          "variable": [],
          "query": []
        },
        "description": "Your usage"
      }
    },
    {
      "name": "listDownloads: Research snapshots",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/downloads",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "downloads"
          ],
          "variable": [],
          "query": []
        },
        "description": "Research snapshots"
      }
    },
    {
      "name": "getHealth: Data freshness",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/health",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "health"
          ],
          "variable": [],
          "query": []
        },
        "description": "Data freshness"
      }
    },
    {
      "name": "createWatchlist: Create a watchlist",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/watchlists",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "watchlists"
          ],
          "variable": [],
          "query": []
        },
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "description": "Create a watchlist"
      }
    },
    {
      "name": "listWatchlists: List your watchlists",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/watchlists",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "watchlists"
          ],
          "variable": [],
          "query": []
        },
        "description": "List your watchlists"
      }
    },
    {
      "name": "deleteWatchlist: Delete a watchlist",
      "request": {
        "method": "DELETE",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/watchlists/:id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "watchlists",
            ":id"
          ],
          "variable": [
            {
              "key": "id",
              "value": "",
              "description": "The watchlist id, such as wl_8c1d2e3f4a5b."
            }
          ],
          "query": []
        },
        "description": "Delete a watchlist"
      }
    },
    {
      "name": "createWebhook: Create a webhook",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/webhooks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "webhooks"
          ],
          "variable": [],
          "query": []
        },
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "description": "Create a webhook"
      }
    },
    {
      "name": "listWebhooks: List your webhooks",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/webhooks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "webhooks"
          ],
          "variable": [],
          "query": []
        },
        "description": "List your webhooks"
      }
    },
    {
      "name": "deleteWebhook: Delete a webhook",
      "request": {
        "method": "DELETE",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/webhooks/:id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "webhooks",
            ":id"
          ],
          "variable": [
            {
              "key": "id",
              "value": "",
              "description": "The webhook id, such as wh_3f9a1c07b2d4."
            }
          ],
          "query": []
        },
        "description": "Delete a webhook"
      }
    },
    {
      "name": "testWebhook: Send a test message",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/webhooks/:id/test",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "webhooks",
            ":id",
            "test"
          ],
          "variable": [
            {
              "key": "id",
              "value": "",
              "description": "The webhook id."
            }
          ],
          "query": []
        },
        "description": "Send a test message"
      }
    },
    {
      "name": "listWebhookDeliveries: Delivery log",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/webhooks/:id/deliveries",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "webhooks",
            ":id",
            "deliveries"
          ],
          "variable": [
            {
              "key": "id",
              "value": "",
              "description": "The webhook id."
            }
          ],
          "query": []
        },
        "description": "Delivery log"
      }
    }
  ]
}