KeyVex Drug Adverse Events API
The Drug Adverse Events API from KeyVex — 1 operation(s) for drug adverse events.
The Drug Adverse Events API from KeyVex — 1 operation(s) for drug adverse events.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/keyvex-com:keyvex-com-drug-adverse-events-api"
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.
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: 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