KeyVex Drug Adverse Events API

The Drug Adverse Events API from KeyVex — 1 operation(s) for drug adverse events.

GitHub OpenAPI

Operations 1

GET /v1/drug-adverse-events Returns FDA FAERS drug adverse-event reports — every adverse-event /… #

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-drug-adverse-events-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-drug-adverse-events-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: KeyVex Drug Adverse Events 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: Drug Adverse Events
paths:
  /v1/drug-adverse-events:
    get:
      operationId: get_drug_adverse_events
      summary: Returns FDA FAERS drug adverse-event reports — every adverse-event /…
      description: 'Returns FDA FAERS drug adverse-event reports — every adverse-event / medication-error report submitted to FDA (~20M, 2004→present, growing ~2M/yr). LIVE passthrough to openFDA: results reflect FDA''s current data and `total_count` is openFDA''s authoritative count for the filtered query (the results array is just the requested page). Use this when the user asks about: safety signals on a drug, adverse events by reaction type, death/hospitalization outcome counts for a product, a manufacturer''s adverse-event footprint, or to pair a safety-signal trend with recalls, approvals, or insider activity. count_by returns TOP TERMS + COUNTS instead of records (e.g. count_by:''reaction'' with drug:''ozempic'' → the most-reported reactions for that drug) — the right first move for ''what are the side effects of X'' questions; follow with a record query for detail. Records are openFDA''s fields verbatim: deeply nested (patient.drug[] with openFDA annotations, patient.reaction[]), 5-15KB each — keep limit small. Matching: drug matches brand name, generic name, or the verbatim reported product as a PHRASE (''ozempic'', ''semaglutide''); reaction is a MedDRA term phrase (''myocardial infarction''); serious=true filters to reports with a serious outcome; outcome picks one specific flag (death, hospitalization, …). since/until window on receivedate (when FDA received the report). CRITICAL honesty note (FDA''s own): FAERS reports are UNVERIFIED and establish NEITHER causation NOR incidence — anyone can report, duplicates exist, reporting is stimulated by publicity, and there is no denominator (prescriptions dispensed). Counts are a reporting signal, not a risk measure. Surface this caveat when presenting counts. Pure-publisher posture: FDA''s records as published, parsed by KeyVex — no derived safety scores.'
      parameters:
      - name: drug
        in: query
        required: false
        description: Drug name phrase — brand ('ozempic'), generic ('semaglutide'), or reported product name.
        schema:
          type: string
      - name: manufacturer
        in: query
        required: false
        description: Manufacturer name phrase (openFDA annotation, e.g. 'novo nordisk').
        schema:
          type: string
      - name: reaction
        in: query
        required: false
        description: MedDRA reaction term phrase (e.g., 'pancreatitis', 'myocardial infarction').
        schema:
          type: string
      - name: serious
        in: query
        required: false
        description: true = serious reports only (death, hospitalization, disability, …); false = non-serious only.
        schema:
          type: boolean
      - name: outcome
        in: query
        required: false
        description: One specific seriousness outcome flag.
        schema:
          type: string
          enum:
          - death
          - life_threatening
          - hospitalization
          - disability
          - congenital_anomaly
          - other
      - name: country
        in: query
        required: false
        description: Country where the event occurred (ISO-2, e.g. 'US').
        schema:
          type: string
      - name: since
        in: query
        required: false
        description: FDA receive-date lower bound (YYYY-MM-DD inclusive).
        schema:
          type: string
      - name: until
        in: query
        required: false
        description: FDA receive-date upper bound (YYYY-MM-DD inclusive).
        schema:
          type: string
      - name: count_by
        in: query
        required: false
        description: 'Facet mode: return top terms + counts instead of records (reaction | drug | brand | manufacturer | country).'
        schema:
          type: string
          enum:
          - reaction
          - drug
          - brand
          - manufacturer
          - country
      - name: limit
        in: query
        required: false
        description: 'Records per page (default 10, max 100 — records are heavy). In count_by mode: facet rows (default 25, max 1000).'
        schema:
          type: integer
      - name: skip
        in: query
        required: false
        description: Pagination offset (openFDA hard cap 25,000). Not used in count_by mode.
        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:
      - Drug Adverse Events
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key