KeyVex Product Recalls API

The Product Recalls API from KeyVex — 1 operation(s) for product recalls.

GitHub OpenAPI

Operations 1

GET /v1/product-recalls Returns safety recalls from federal agencies — drug recalls (FDA), medical… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/keyvex-com:keyvex-com-product-recalls-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

keyvex-com-product-recalls-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: KeyVex Product Recalls API
  version: 0.102.0
  termsOfService: https://keyvex.com/terms
  description: 'US public financial-disclosure data — congressional trades, insider filings (Form 4), lobbying, Treasury auctions, member profiles. Requires an API key — create a free one at https://keyvex.com and send it as the header `x-api-key: `. A free key returns most public-record datasets (one year of history; no market-price data and a few heavy datasets are on paid plans only), capped at 60 requests/day; paid plans raise the caps. The daily allowance resets at midnight Eastern.'
servers:
- url: https://api.keyvex.com
security:
- ApiKeyAuth: []
tags:
- name: Product Recalls
paths:
  /v1/product-recalls:
    get:
      operationId: get_product_recalls
      summary: Returns safety recalls from federal agencies — drug recalls (FDA), medical…
      description: 'Returns safety recalls from federal agencies — drug recalls (FDA), medical device recalls (FDA), food/dietary supplement recalls (FDA), consumer-product recalls (CPSC), and vehicle, equipment, tire and child-restraint recall campaigns (NHTSA, since 1966). Use this when the user asks about: recent recalls for a specific company or product, FDA Class I (most severe) recalls, food contamination recalls, drug shortages and recalls, vehicle recalls by make or model (e.g. all Ford F-150 recalls), or to add a ''product-safety event'' flag to insider activity / 8-K filings / enforcement actions. Sources (filter via the `source` enum): fda_drug — openFDA /drug/enforcement.json. Drug recalls including prescription, OTC, biologics. Class I/II/III severity. fda_device — openFDA /device/enforcement.json. Medical device recalls (implants, diagnostics, equipment, software). Same classification scheme. fda_food — openFDA /food/enforcement.json. Food + dietary supplements. Pathogen contamination, allergen mislabeling, etc. cpsc — saferproducts.gov RestWebServices/Recall. Consumer-product recalls (clothing, electronics, toys, batteries, etc.). No severity classification; classification field is null. nhtsa — NHTSA recall campaigns from NHTSA''s flat files, updated daily. One row per campaign (recall_number = NHTSA''s campaign number, e.g. ''26V652000''); recalling_firm = the manufacturer that filed the defect report; product_description = NHTSA''s defect summary; reason_for_recall = its consequence; remedy and notes as NHTSA writes them. Consumer advisories first: do_not_drive (NHTSA advises owners not to drive the vehicle until it is repaired) and park_outside (park outside, away from structures: fire risk); null on campaigns that predate the advisories. product_quantity is NHTSA''s potential units affected (null when not stated); vehicle_model_year_count is the number of distinct make/model/year combinations, not units. makes lists up to 20 makes (''+N more'' beyond). A campaign''s full vehicle list comes only with source=nhtsa + recall_number: `vehicles` (500 per page, by make / model / year), `vehicles_total`, and `vehicles_next_cursor` (pass it back as vehicles_cursor). classification and status are null (NHTSA uses neither). A campaign NHTSA''s file stops listing keeps its row: nhtsa_listing says ''no longer listed by NHTSA'' and nhtsa_unlisted_since is the date KeyVex first observed it missing (NHTSA publishes no removal date or reason); both are null while NHTSA lists it. Source: NHTSA Office of Defects Investigation; public domain (http://www.usa.gov/publicdomain/label/1.0/). Cross-source pairing pattern: Recall → 8-K Item 7.01/8.01: pair with get_material_events Recall → insider sells: pair with get_insider_transactions Recall → SEC/DOJ follow-on: pair with get_enforcement_actions Recall → company filings: pair with get_proxy_filings (DEF 14A risk factors) Each record is one recall. Identifier format: `{source}-{recall_number}` (e.g., ''fda_drug-D-1234-2026''). FDA classifications: Class I — serious adverse health consequence or death Class II — temporary or reversible health consequence Class III — unlikely to cause adverse health consequence Source freshness (per-source publication cadence, not KeyVex bug): CPSC publishes within ~1-2 days; recent data flows hourly-fresh. openFDA''s snapshot updates every ~10-14 days, and each snapshot carries recall_initiation_date values that LAG the snapshot date by another 30-45 days (the time between FDA classifying a recall and openFDA exposing it). Net: FDA records in this collection typically run ~4-6 weeks behind real-world recall dates, while CPSC is current. A default desc-by-date sort therefore looks CPSC-heavy at the top even when FDA matters more for the query. Filter by source=''fda_*'' to see FDA-only and avoid the skew. Searching recalling_firm / product_description: case-insensitive; 4+ characters match anywhere, 1-3 characters match a whole word (''3M'', ''GE'').'
      parameters:
      - name: source
        in: query
        required: false
        description: Filter to a single agency / category. Omit to see all sources combined.
        schema:
          type: string
          enum:
          - fda_drug
          - fda_device
          - fda_food
          - nhtsa
          - cpsc
      - name: recall_number
        in: query
        required: false
        description: Recall identifier as filed (e.g., FDA 'D-1234-2026', NHTSA '26V652000'). Combine with source for direct doc lookup, fastest path; with source=nhtsa the answer also lists the campaign's vehicles.
        schema:
          type: string
      - name: recalling_firm
        in: query
        required: false
        description: 'The recalling firm''s name (e.g., ''Pfizer'', ''Abbott'', ''Whole Foods''). Case-insensitive. 4+ characters match anywhere in the text; 1-3 characters match a whole word (''3M'', ''GE'', ''ABC''). A term of 3+ characters searches EVERY recall. A 1-2 character term searches only a window: the newest 5,000 recalls (the oldest, with sort_order=asc) that your other filters select (source, dates, classification, status, a 3+ character term); coverage_warning says so, and since/until move the window.'
        schema:
          type: string
      - name: product_description
        in: query
        required: false
        description: 'The product description (e.g., ''lithium'', ''romaine'', ''insulin pump''). Case-insensitive. 4+ characters match anywhere in the text; 1-3 characters match a whole word (''3M'', ''GE'', ''ABC''). A term of 3+ characters searches EVERY recall. A 1-2 character term searches only a window: the newest 5,000 recalls (the oldest, with sort_order=asc) that your other filters select (source, dates, classification, status, a 3+ character term); coverage_warning says so, and since/until move the window.'
        schema:
          type: string
      - name: classification
        in: query
        required: false
        description: FDA severity classification. Class I is most severe (death / serious harm). Ignored for CPSC records.
        schema:
          type: string
          enum:
          - Class I
          - Class II
          - Class III
      - name: status
        in: query
        required: false
        description: 'Exact match. Common values: ''Ongoing'', ''Completed'', ''Terminated'', ''Recall Initiated''.'
        schema:
          type: string
      - name: vehicle_make
        in: query
        required: false
        description: NHTSA campaigns that name a vehicle of this make (e.g., 'Ford', 'Toyota'). Exact make, case- and space-insensitive. Matches NHTSA rows only.
        schema:
          type: string
      - name: vehicle_model
        in: query
        required: false
        description: 'NHTSA campaigns that name a vehicle model containing this text (e.g., ''F-150'', ''Camry''). Matches NHTSA rows only. Case-insensitive. 4+ characters match anywhere in the text; 1-3 characters match a whole word (''3M'', ''GE'', ''ABC''). A term of 3+ characters searches EVERY recall. A 1-2 character term searches only a window: the newest 5,000 recalls (the oldest, with sort_order=asc) that your other filters select (source, dates, classification, status, a 3+ character term); coverage_warning says so, and since/until move the window.'
        schema:
          type: string
      - name: vehicles_cursor
        in: query
        required: false
        description: 'With source=nhtsa + recall_number: the vehicles_next_cursor of the previous answer, for the campaign''s next 500 vehicles.'
        schema:
          type: string
      - name: since
        in: query
        required: false
        description: ISO date (YYYY-MM-DD). Only recalls whose recall_initiation_date is on or after this date.
        schema:
          type: string
      - name: until
        in: query
        required: false
        description: ISO date (YYYY-MM-DD). Only recalls whose recall_initiation_date is on or before this date.
        schema:
          type: string
      - name: sort_by
        in: query
        required: false
        description: 'Default: recall_initiation_date.'
        schema:
          type: string
          enum:
          - recall_initiation_date
          - posted_date
      - name: sort_order
        in: query
        required: false
        description: 'Default: desc (most recent first).'
        schema:
          type: string
          enum:
          - desc
          - asc
      - name: limit
        in: query
        required: false
        description: Maximum records to return. Default 50, max 500.
        schema:
          type: integer
      responses:
        '200':
          description: 'JSON envelope: { results: [...], count, has_more }.'
        '400':
          description: Invalid parameter.
        '401':
          description: Missing or invalid API key.
        '402':
          description: This tool requires a higher plan (upgrade_required). Retrying will not help.
        '429':
          description: Tier rate/quota limit reached (rate_limited). Retry-After points at the reset.
      tags:
      - Product Recalls
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key