Maxwell International Openfda API

The openfda API from Maxwell International — 4 operation(s) for openfda.

GitHub OpenAPI

Operations 4

GET /v1/openfda/drug/enforcement FDA drug recalls (enforcement reports) from openFDA, newest first: matches… #
GET /v1/openfda/drug/event FDA adverse event reports (FAERS) for a drug from openFDA, newest first: report… #
GET /v1/openfda/drug/label FDA drug labels (package inserts) by brand or generic name from openFDA, newest… #
GET /v1/openfda/food/enforcement FDA food recalls (enforcement reports) from openFDA, newest first: matches… #

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/maxwellinternational-ai:maxwellinternational-ai-openfda-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

maxwellinternational-ai-openfda-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Maxwell International Data (x402) Openfda API
  version: 1.0.0
  description: Machine-only pay-per-call data API over x402. Prices are per request in USDC.
  x-guidance: 'Pay-per-call data for ski trips and public records, plus x402 Doctor, which tests other x402 endpoints for you. Ski: a directory of about 6,000 ski resorts worldwide, lift-ticket prices for the resorts listed at /v1/ski/coverage, a model forecast for every resort (station readings where one of 11 European met services has a station), lift status and snow reports only at about 50 resorts with their own feed (in Poland, Slovakia, Switzerland, Liechtenstein and Friuli in Italy; only while current), insider tips, and the Trip Wizard (a free map, then one paid call per trip step). Food: restaurants around ski resorts in every country listed at /v1/food/coverage (free, with per-country counts), with opening hours, website and contacts where known. Menus and prices only where read (withMenu): in Andorra, Austria, Bulgaria, Czechia, Finland, France, Germany, Italy, Liechtenstein, Norway, Poland, Slovakia, Slovenia, Spain, Sweden and Switzerland from the restaurant’s own website or, where none is published, a delivery app; in every other country only where a delivery app (Wolt, Bolt Food, Glovo, Pyszne.pl) lists the restaurant, as restaurants’ own websites are read for menus only in those 16 countries. Public data: SEC EDGAR, government registers and legislation of 13 countries and the EU, OFAC SDN, NVD CVEs, openFDA, NOAA weather (US), ECB FX, FRED, npm, RDAP domain records, crypto market quotes, US court opinions, US patents. Paid operations are GET, except doctor.payment and llm.chat (POST with a JSON body). Call one without payment to receive HTTP 402 with a PAYMENT-REQUIRED header (x402 v2): USDC on Base (eip155:8453) or Solana, settled through the Coinbase CDP facilitator. Send the same request again with a PAYMENT-SIGNATURE header. You are charged only for a 2xx answer. Missing or ambiguous parameters get a free 400 or 409 and a request with no data on file a free 404, both with charged:false. A search that runs and finds nothing is a 2xx answer (match:false) and is charged. Most routes check parameters before asking for payment. A bare path (directory probes), ski.prices without country, gov.de legislation and open data, and a POST without the fields it needs get the 402 first; after payment a request that cannot be answered still gets a free 400 (ski.prices answers if the resort id is unique). food.menu without restaurantId is a free 404. Paid answers that can look empty: a search with no matches (match:false), an RDAP lookup of an unregistered domain (registered:false) or of a registry without RDAP (rdapAvailable:false), and gov.de legislation or open data without q or id (the index of what is cached). doctor.buy and llm.chat collect the payment before they run: doctor.buy charges for the attempt, delivered or not; if the llm.chat model fails after payment, the answer (HTTP 503, llm_failed_after_payment) says charged:true and the payment is refunded by hand. A lookup of one item that is not cached yet (CVE, accession, company number, coordinates) is usually queued: retry after retryAfterSec. Priced per request (x-payment-info mode dynamic, with min and max where there is one): doctor.buy, llm.chat, trip.bundle; the 402 quotes the exact amount. Every other product has one price. Each response carries fetchedAt or generatedAt. Forecasts refresh every 6 hours, and lift status every 15 minutes where the resort has a feed. Hand-checked lift-ticket prices were read from official price lists on Oct 7-9, 2026 (rechecks from Nov 8); the others come from a weekly crawl of the resort''s price pages or from an earlier collection (operator shops, price pages); every row has its source link and read date. Public records refresh on each source''s schedule (age per family at /health). Free status and coverage endpoints are listed at /catalog.json; terms at /terms.json. Free samples: most products have one real request you can call free to check the data first (freeSampleUrl in /catalog.json, x-free-sample here, freeSample in every 402): the same answer a buyer of that request gets.'
  contact:
    name: Maxwell International
    email: accounts@maxwellinternational.ai
    url: https://api.maxwellinternational.ai/terms.json
  termsOfService: https://api.maxwellinternational.ai/terms.json
servers:
- url: https://api.maxwellinternational.ai
tags:
- name: openfda
paths:
  /v1/openfda/drug/enforcement:
    get:
      operationId: openfda_drug_enforcement
      summary: 'FDA drug recalls (enforcement reports) from openFDA, newest first: matches…'
      description: 'FDA drug recalls (enforcement reports) from openFDA, newest first: matches product, firm, reason, brand or generic name. Each recall has its number, class (I-III), status, reason, firm, dates, distribution and quantity. ?q=valsartan; 10 by default, up to 25 with &limit=. Answers are cached for up to 24 hours.'
      tags:
      - openfda
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
        example: valsartan
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        example: 5
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
        protocols:
        - x402: {}
      x-free-sample:
        url: https://api.maxwellinternational.ai/v1/openfda/drug/enforcement?q=valsartan&sample=1
        note: 'This exact request is free (a few per hour): the same answer a buyer gets.'
      responses:
        '200':
          description: Paid response (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  query:
                    type: string
                  kind:
                    type: string
                  source:
                    type: string
                  fetchedAt:
                    type: string
                  meta:
                    type: object
                    properties:
                      disclaimer:
                        type: string
                      terms:
                        type: string
                      license:
                        type: string
                      last_updated:
                        type: string
                      results:
                        type: object
                        properties:
                          skip:
                            type: integer
                          limit:
                            type: integer
                          total:
                            type: integer
                  count:
                    type: integer
                  total:
                    type: integer
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        recall_number:
                          type: string
                        status:
                          type: string
                        classification:
                          type: string
                        product_description:
                          type: string
                        reason_for_recall:
                          type: string
                        recalling_firm:
                          type: string
                        report_date:
                          type: string
                        recall_initiation_date:
                          type: string
                        termination_date: {}
                        distribution_pattern:
                          type: string
                        product_quantity: {}
                        code_info:
                          type: string
                        city:
                          type: string
                        state:
                          type: string
                        country:
                          type: string
                        voluntary_mandated:
                          type: string
                        brand_names:
                          type: array
                          items:
                            type: string
                        generic_names:
                          type: array
                          items:
                            type: string
                  notice:
                    type: string
                  match:
                    type: boolean
              example:
                query: valsartan
                kind: drug_enforcement
                source: https://api.fda.gov/drug/enforcement.json
                fetchedAt: '2026-10-05T09:28:41.825Z'
                meta:
                  disclaimer: Do not rely on openFDA to make decisions regarding medical care. While we mak…
                  terms: https://open.fda.gov/terms/
                  license: https://open.fda.gov/license/
                  last_updated: '2026-09-23'
                  results:
                    skip: 0
                    limit: 10
                    total: 48
                count: 10
                total: 48
                results:
                - recall_number: D-0746-2026
                  status: Ongoing
                  classification: Class II
                  product_description: 'Diovan (valsartan) 160 mg, 90 tablets, Rx only, Manufactured by: Patheon Manu…'
                  reason_for_recall: Failed Dissolution Specifications
                  recalling_firm: Novartis Pharmaceuticals Corporation
                  report_date: '20260819'
                  recall_initiation_date: '20260804'
                  termination_date: null
                  distribution_pattern: US Nationwide
                  product_quantity: null
                  code_info: 'Lot AV5913C, Expiry: 6/2027'
                notice: Do not rely on openFDA to make decisions regarding medical care. Always speak…
                match: true
        '400':
          description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
        '402':
          description: Payment Required
        '404':
          description: No data on file for this request (not cached or not found); not charged (charged:false)
  /v1/openfda/drug/event:
    get:
      operationId: openfda_drug_event
      summary: 'FDA adverse event reports (FAERS) for a drug from openFDA, newest first: report…'
      description: 'FDA adverse event reports (FAERS) for a drug from openFDA, newest first: report id, date received, seriousness (death, hospitalisation, life-threatening), reactions, drugs taken and indication. ?q=metformin; 5 by default, up to 25 with &limit=. Cached for up to 24 hours. Reports are not proof the drug caused the event.'
      tags:
      - openfda
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
        example: metformin
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        example: 5
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
        protocols:
        - x402: {}
      x-free-sample:
        url: https://api.maxwellinternational.ai/v1/openfda/drug/event?q=metformin&sample=1
        note: 'This exact request is free (a few per hour): the same answer a buyer gets.'
      responses:
        '200':
          description: Paid response (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  query:
                    type: string
                  kind:
                    type: string
                  note:
                    type: string
                  topReactions:
                    type: array
                    items:
                      type: object
                      properties:
                        reaction:
                          type: string
                        reports:
                          type: integer
                  source:
                    type: string
                  fetchedAt:
                    type: string
                  meta:
                    type: object
                    properties:
                      disclaimer:
                        type: string
                      terms:
                        type: string
                      license:
                        type: string
                      last_updated:
                        type: string
                      results:
                        type: object
                        properties:
                          skip:
                            type: integer
                          limit:
                            type: integer
                          total:
                            type: integer
                  count:
                    type: integer
                  total:
                    type: integer
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        safetyreportid:
                          type: string
                        receivedate:
                          type: string
                        serious:
                          type: boolean
                        seriousnessdeath:
                          type: boolean
                        seriousnesshospitalization:
                          type: boolean
                        seriousnesslifethreatening:
                          type: boolean
                        reactions:
                          type: array
                          items:
                            type: string
                        queriedDrugRole:
                          type: string
                        drugCount:
                          type: integer
                        drugs:
                          type: array
                          items:
                            type: object
                  notice:
                    type: string
                  match:
                    type: boolean
              example:
                query: metformin
                kind: drug_event
                note: Reports where the queried drug is a suspect, newest first (queriedDrugRole pe…
                topReactions:
                - reaction: NAUSEA
                  reports: 31637
                source: https://api.fda.gov/drug/event.json
                fetchedAt: '2026-10-05T09:42:35.769Z'
                meta:
                  disclaimer: Do not rely on openFDA to make decisions regarding medical care. While we mak…
                  terms: https://open.fda.gov/terms/
                  license: https://open.fda.gov/license/
                  last_updated: '2026-07-30'
                  results:
                    skip: 0
                    limit: 100
                    total: 459569
                count: 5
                total: 459569
                results:
                - safetyreportid: '26940686'
                  receivedate: '2026-06-30'
                  serious: false
                  seriousnessdeath: false
                  seriousnesshospitalization: false
                  seriousnesslifethreatening: false
                  reactions: []
                  queriedDrugRole: suspect
                  drugCount: 4
                  drugs: []
                notice: Do not rely on openFDA to make decisions regarding medical care. Always speak…
                match: true
        '400':
          description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
        '402':
          description: Payment Required
        '404':
          description: No data on file for this request (not cached or not found); not charged (charged:false)
  /v1/openfda/drug/label:
    get:
      operationId: openfda_drug_label
      summary: FDA drug labels (package inserts) by brand or generic name from openFDA, newest…
      description: 'FDA drug labels (package inserts) by brand or generic name from openFDA, newest label first: brand, generic name, manufacturer, indications and usage, warnings, label date. ?q=ibuprofen; 5 labels by default, up to 25 with &limit=. Answers are cached for up to 24 hours. Not medical advice.'
      tags:
      - openfda
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
        example: atorvastatin
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        example: 5
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
        protocols:
        - x402: {}
      x-free-sample:
        url: https://api.maxwellinternational.ai/v1/openfda/drug/label?q=atorvastatin&sample=1
        note: 'This exact request is free (a few per hour): the same answer a buyer gets.'
      responses:
        '200':
          description: Paid response (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  query:
                    type: string
                  source:
                    type: string
                  fetchedAt:
                    type: string
                  meta:
                    type: object
                    properties:
                      disclaimer:
                        type: string
                      terms:
                        type: string
                      license:
                        type: string
                      last_updated:
                        type: string
                      results:
                        type: object
                        properties:
                          skip:
                            type: integer
                          limit:
                            type: integer
                          total:
                            type: integer
                  count:
                    type: integer
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        brand:
                          type: string
                        generic:
                          type: string
                        manufacturer:
                          type: string
                        warnings:
                          type: array
                        indications_and_usage:
                          type: array
                          items:
                            type: string
                        effective_time:
                          type: string
                  notice:
                    type: string
                  match:
                    type: boolean
              example:
                query: atorvastatin
                source: https://api.fda.gov/drug/label.json
                fetchedAt: '2026-10-05T09:44:35.806Z'
                meta:
                  disclaimer: Do not rely on openFDA to make decisions regarding medical care. While we mak…
                  terms: https://open.fda.gov/terms/
                  license: https://open.fda.gov/license/
                  last_updated: '2026-10-02'
                  results:
                    skip: 0
                    limit: 5
                    total: 260
                count: 5
                results:
                - id: 68d09be6-1a04-4117-85dc-1d975e475c6a
                  brand: ATORVASTATIN CALCIUM
                  generic: ATORVASTATIN CALCIUM
                  manufacturer: Apotex Corp.
                  warnings: []
                  indications_and_usage: []
                  effective_time: '20260908'
                notice: Do not rely on openFDA to make decisions regarding medical care. Always speak…
                match: true
        '400':
          description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
        '402':
          description: Payment Required
        '404':
          description: No data on file for this request (not cached or not found); not charged (charged:false)
  /v1/openfda/food/enforcement:
    get:
      operationId: openfda_food_enforcement
      summary: 'FDA food recalls (enforcement reports) from openFDA, newest first: matches…'
      description: 'FDA food recalls (enforcement reports) from openFDA, newest first: matches product, firm or reason. Each recall has its number, class (I-III), status, reason, firm, dates, distribution and quantity. ?q=listeria; 10 by default, up to 25 with &limit=. Answers are cached for up to 24 hours.'
      tags:
      - openfda
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
        example: listeria
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        example: 5
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
        protocols:
        - x402: {}
      x-free-sample:
        url: https://api.maxwellinternational.ai/v1/openfda/food/enforcement?q=listeria&sample=1
        note: 'This exact request is free (a few per hour): the same answer a buyer gets.'
      responses:
        '200':
          description: Paid response (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  query:
                    type: string
                  kind:
                    type: string
                  source:
                    type: string
                  fetchedAt:
                    type: string
                  meta:
                    type: object
                    properties:
                      disclaimer:
                        type: string
                      terms:
                        type: string
                      license:
                        type: string
                      last_updated:
                        type: string
                      results:
                        type: object
                        properties:
                          skip:
                            type: integer
                          limit:
                            type: integer
                          total:
                            type: integer
                  count:
                    type: integer
                  total:
                    type: integer
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        recall_number:
                          type: string
                        status:
                          type: string
                        classification:
                          type: string
                        product_description:
                          type: string
                        reason_for_recall:
                          type: string
                        recalling_firm:
                          type: string
                        report_date:
                          type: string
                        recall_initiation_date:
                          type: string
                        termination_date: {}
                        distribution_pattern:
                          type: string
                        product_quantity:
                          type: string
                        code_info:
                          type: string
                        city:
                          type: string
                        state:
                          type: string
                        country:
                          type: string
                        voluntary_mandated:
                          type: string
                        brand_names:
                          type: array
                        generic_names:
                          type: array
                  notice:
                    type: string
                  match:
                    type: boolean
              example:
                query: listeria
                kind: food_enforcement
                source: https://api.fda.gov/food/enforcement.json
                fetchedAt: '2026-10-05T07:36:46.386Z'
                meta:
                  disclaimer: Do not rely on openFDA to make decisions regarding medical care. While we mak…
                  terms: https://open.fda.gov/terms/
                  license: https://open.fda.gov/license/
                  last_updated: '2026-09-23'
                  results:
                    skip: 0
                    limit: 10
                    total: 7494
                count: 10
                total: 7494
                results:
                - recall_number: H-1388-2026
                  status: Ongoing
                  classification: Class I
                  product_description: Mon Sire Brie, soft-ripened French cheese, 1 kg, packed in carboard carton an…
                  reason_for_recall: The firm was notified by their Brie Cheese supplier that sample results revea…
                  recalling_firm: Optimus Inc. d/b/a/ Markys Caviar
                  report_date: '20260923'
                  recall_initiation_date: '20260825'
                  termination_date: null
                  distribution_pattern: Florida
                  product_quantity: 22 cases (44 units)
                  code_info: LOT 00000ZRAA1  EXP 08/15/2026 LOT 00000ZUAD2  EXP 08/18/2026
                notice: Do not rely on openFDA to make decisions regarding medical care. Always speak…
                match: true
        '400':
          description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
        '402':
          description: Payment Required
        '404':
          description: No data on file for this request (not cached or not found); not charged (charged:false)