Call the REST API

REST reference

Read-only GET endpoints with JSON replies. Generated from the same tool definitions as the MCP server, so names, parameters and replies match. Spec: OpenAPI 3.1.

Conventions#

Base URL
https://fdaintel.ai/api/intel/v1
Auth
Authorization: Bearer fdi_ak_… (authentication)
Paging
Lists return total, offset, limit, returned, next_offset. Repeat with offset=next_offset until it is null.
Lists in a query
doc_type=483,eir or repeat the key.
Dates
2023, 2023-06 or 2023-06-15; replies use ISO 8601.
Any tool
GET /api/intel/v1/call/{tool} with the tool's arguments as query parameters. GET /api/intel/v1 lists everything.
CORS
Open: browser apps can call it with a key the user supplies.

Endpoints#

Each endpoint is one MCP tool. Full parameter descriptions and example replies are on the tool pages.

Inspection documents

GET/api/intel/v1/call/fetchFetch a document

Fetch one FDA Intel document by id: its summary, observation previews and every metadata field. The full document is not included; the "document" field gives its type, date, observations, pages, price_usd and link on FDA Intel.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/call/fetch?id=ex4mpl3d0c01

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/documentsSearch documents with filters

Search documents with every available filter (keyword, type, firm, FEI, investigator, place, date range, CFR section, observation text, product type, classification, topic, sector …). Returns total, a page of documents with all list fields (summary included) and next_offset.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/documents?doc_type=483%2Cwarning_letter&fei=3001234567&date_from=2020&limit=10

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/documents/{id}Get everything about a document

Everything about one document: metadata, summary, investigators (with career stats), each 483 observation's opening words with its CFR citations, system area and topics, inspection classification, warning-letter data (violations with CFR citations and response verdicts, linked 483s/EIRs, close-out), follow-on actions and other documents for the same site. The full document is not included; the "document" field gives its type, date, observations, pages, price_usd and link on FDA Intel.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/documents/ex4mpl3d0c01

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/observationsSearch observations and violations

Search individual 483 observations and warning-letter violations by words, CFR section, system area, topic or repeat flag, with the same document filters as search_documents (firm, FEI, investigator, dates, type, place …). Each hit has the statement's opening words, CFR citations, area, topics and its document.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/observations?cfr=211.192&topic=investigations&date_from=2023&limit=10

Paste an API key from your account page to send a real request. Each request counts against your plan.

Firms and investigators

GET/api/intel/v1/firmsSearch firms and sites

Find firms / inspected sites in the FDA Intel catalog by name, alias, FEI or place. A name query matches firms whose name contains every word (exact and prefix matches first); only if none do does it fall back to a short list of similar names (match: fuzzy). Returns firm ids, FEI, location, document counts and last document date.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/firms?q=Example+Pharma&country=India

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/firms/{id}Firm / site profile

Full profile of a firm or site (by firm id, numeric id or FEI): all its documents (paged), investigators who inspected it, most-cited CFR sections, observation topics and system areas, inspection classifications, warning letters, and FDA public history for the FEI (inspections, compliance actions, recalls, import refusals, import alerts). Use for pre-inspection briefs.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/firms/3001234567?limit=25

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/investigatorsSearch FDA investigators

Find FDA investigators by name (fuzzy, any variant). Returns ids, document and site counts, first/last seen.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/investigators?q=Jane+Example

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/investigators/{id}Investigator profile

Full profile of an FDA investigator: stats (483s, EIRs, average observations, inspection length, OAI share), every document (paged), sites inspected, co-investigators, the CFR sections, topics and system areas they cite most, classifications and centers by year. Use for pre-inspection briefs.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/investigators/jane-example?limit=25

Paste an API key from your account page to send a real request. Each request counts against your plan.

Regulations and catalog

GET/api/intel/v1/cfrSearch regulations (21 CFR)

Find 21 CFR sections by citation (211.192, part 820) or words in the heading/text, with how often each is cited in 483s/EIRs and warning letters.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/cfr?q=211.192

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/cfr/{citation}Regulation detail

One 21 CFR section: heading, full text, summary, firms cited most, sections cited alongside, observation topics, and the documents citing it (paged).

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/cfr/211.192?limit=10

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/facetsFilter values and counts

Every filter value with its document count: document types, centers, establishment types, countries, states, product types, sectors, agencies, classifications, system areas, topics, years, warning-letter offices.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/facets

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/statsCatalog statistics

Approximate size of the FDA Intel catalog: documents by type, observations, warning letters, firms, investigators and the date range.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/stats

Paste an API key from your account page to send a real request. Each request counts against your plan.

FDA public data

GET/api/intel/v1/call/find_facilityFind a facility

Find FDA-regulated facilities by name (every word must match) or FEI, across FDA inspections and drug / device establishment registrations. Returns FEI, name, place, last inspection date and how many inspections. Follow with facility_signal.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/call/find_facility?q=Example+Pharma+Unit+II&country=India

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/call/facility_signalFacility signal

A facility's current FDA standing by FEI, with a one-paragraph summary: last inspection and outcome (NAI/VAI/OAI), inspections in 5 years, warning letters and whether a close-out was posted, import alert status (red / yellow / green list), recent recalls, import refusals in 12 months, compliance actions, drug / device registration, and FDA Intel documents on file for the FEI.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/call/facility_signal?fei=3001234567

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/call/inspection_historyInspection history with citations

Every FDA inspection of a facility (FEI), newest first: date, classification, project area, product type, and the 21 CFR citations FDA published for it with FDA's citation text.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/call/inspection_history?fei=3001234567&limit=10

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/call/search_inspectionsSearch FDA inspections

Search FDA inspections across all firms by name, FEI, classification (NAI/VAI/OAI), project area, product type, country, state or date range. Newest first.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/call/search_inspections?classification=OAI&product_type=Drugs&country=India&date_from=2024

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/call/search_recallsSearch recalls

FDA recall enforcement reports (drugs, devices, food): by recalling firm, product or reason words, FEI, center, class (I, II, III), status, recall number or date range. Newest first.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/call/search_recalls?firm=Example+Pharma&center=drug&date_from=2023

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/call/search_import_alertsImport alerts

FDA import alerts. With alert_no: the alert and the firms on its red / yellow / green lists. With firm, FEI, country or list: matching listed firms. With only q (or nothing): the alerts themselves by title or number.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/call/search_import_alerts?fei=3001234567

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/call/warning_letter_statusWarning-letter status

FDA's warning-letter index: company, issue and posting dates, issuing office, subject, and whether a response and a close-out letter were posted. Filter by company, MARCS-CMS number, office, subject words, closed_out or date range.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/call/warning_letter_status?company=Example+Pharma&date_from=2022

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/call/drug_shortagesDrug shortages

FDA drug shortage list: generic name, company, presentation, status (Current, To Be Discontinued, Resolved), availability, reason and dates.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/call/drug_shortages?q=cisplatin&status=Current

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/call/search_registrationsEstablishment registrations

FDA establishment registrations. kind=drug: registered drug establishments (FEI, DUNS, operations, registration expiry). kind=device: registered device establishments (registration number, FEI, establishment types, product codes).

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/call/search_registrations?kind=drug&fei=3001234567

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/call/lookup_510k510(k) clearances

Device 510(k) clearances by K number, device / applicant words, applicant, product code or decision date range, with the device class and regulation number.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/call/lookup_510k?k_number=K000001

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/call/lookup_pmaPMA approvals

Device premarket approvals (PMA) by PMA number, trade / generic name or applicant words, or product code. First approvals only by default; include_supplements=true adds supplements.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/call/lookup_pma?q=Example+stent

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/call/lookup_ndcNDC directory

Drug products in the NDC directory by NDC, brand / generic name words, labeler or application number: dosage form, route, marketing category and dates, active ingredients.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/call/lookup_ndc?q=examplomab

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/call/lookup_drug_applicationDrug applications (Drugs@FDA)

Approved drug applications (NDA, ANDA, BLA) by application number, brand / ingredient words or sponsor: first approval, last submission, products and (by number) the submission history.

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/call/lookup_drug_application?application_number=ANDA000001

Paste an API key from your account page to send a real request. Each request counts against your plan.

GET/api/intel/v1/call/check_debarmentDebarment check

Check a person or firm name against FDA's debarment list and the clinical investigator disqualification list (name match only).

Parameters and example reply

GET https://fdaintel.ai/api/intel/v1/call/check_debarment?q=John+Example

Paste an API key from your account page to send a real request. Each request counts against your plan.

OpenAPI spec#

The OpenAPI 3.1 description lives at a stable URL. Import it into Postman, Insomnia or a client generator.

https://fdaintel.ai/api/openapi.json