REST reference

Soon[2 endpoints]View as Markdown

FDA

Drug application, product, and approval history for pilot US-listed biotech and pharmaceutical sponsors from Drugs@FDA.

Paths are relative to https://api.agentdatasets.com. Every endpoint mirrors an MCP tool over the same service layer — the tool catalog documents the same operations for MCP clients.

GET/v1/fda/approvals

Get Approvals Route

Return full curated detail for one to ten FDA applications.

Parameters

NameTypeRequiredDefaultConstraintsDescription
application_numbersarray<string>Yesmin items 1, max items 10Repeated exact Drugs@FDA application number (one to ten)

Example request

Required parameters only, with values taken from the schema. Optional parameters are in the table above.

[ BASH ]
curl --fail --silent --show-error \
  --header "X-API-KEY: adk_..." \
  "https://api.agentdatasets.com/v1/fda/approvals?application_numbers=APPLICATION_NUMBERS"

Response

200 Successful Response · expand a branch to see its fields.

  • dataFdaApprovalsDetailDatarequiredApplication details in the caller's requested order.
    • applicationsarray<FdaApprovalDetail>required
      • application_numberstringrequired
      • sponsorFdaSponsorrequiredCatalog identity joined to the sponsor name published by Drugs@FDA.
        • companystringrequired
        • tickerstringrequired
        • keystringrequired
        • sponsor_namestringrequired
      • brand_namesarray<string>required
      • generic_namesarray<string>required
      • productsarray<FdaProduct>required
        • product_numberstringrequirednullable
        • brand_namestringrequirednullable
        • active_ingredientsarray<FdaActiveIngredient>required
          • namestringrequirednullable
          • strengthstringrequirednullable
        • dosage_formstringrequirednullable
        • routestringrequirednullable
        • marketing_statusstringrequirednullable
      • submissionsarray<FdaSubmissionDetail>required
        • submission_typestringrequired
        • submission_numberstringrequired
        • submission_statusstringrequirednullable
        • submission_status_datestring (date)requirednullable
        • approval_datestring (date)requirednullable
        • submission_class_codestringrequirednullable
        • submission_class_code_descriptionstringrequirednullable
        • review_prioritystringrequirednullable
      • source"openfda_drugsfda"default "openfda_drugsfda"
      • as_ofstring (date-time)required
  • metaMetarequiredResult-level provenance. ``source`` is a stable connector identifier (e.g. ``sec_edgar_companyfacts``); ``as_of`` is the freshest value-level ``as_of`` on the returned page, or ``None`` when the page is empty. Event-grained sources carry an aware datetime; date-grained sources (e.g. an SEC filing's report period) carry a plain date.
    • sourcestringrequired
    • as_ofstring (date-time) | string (date)nullable
  • paginationPaginationnullable
    • limitintegerrequired
    • has_morebooleanrequired
    • next_cursorstringnullable

Search Approvals Route

Return bounded, cursor-paged Drugs@FDA approval events.

Parameters

NameTypeRequiredDefaultConstraintsDescription
sponsorstring | nullNoPilot sponsor ticker, catalog key, or exact company name
drugstring | nullNoCase-insensitive brand or generic drug-name substring
approved_afterstring (date) | nullNoInclusive lower approval-date bound (YYYY-MM-DD)
approved_beforestring (date) | nullNoInclusive upper approval-date bound (YYYY-MM-DD)
limitintegerNo10min 1, max 50Approval events, newest first
cursorstring | nullNoOpaque pagination.next_cursor from the previous response

Example request

Required parameters only, with values taken from the schema. Optional parameters are in the table above.

[ BASH ]
curl --fail --silent --show-error \
  --header "X-API-KEY: adk_..." \
  "https://api.agentdatasets.com/v1/fda/approvals/search"

Response

200 Successful Response · expand a branch to see its fields.

  • dataFdaApprovalSearchDatarequiredEchoed approval filters and the bounded newest-first matches.
    • sponsorstringrequirednullable
    • drugstringrequirednullable
    • approved_afterstring (date)requirednullable
    • approved_beforestring (date)requirednullable
    • matchesarray<FdaApprovalMatch>required
      • application_numberstringrequired
      • sponsorFdaSponsorrequiredCatalog identity joined to the sponsor name published by Drugs@FDA.
        • companystringrequired
        • tickerstringrequired
        • keystringrequired
        • sponsor_namestringrequired
      • brand_namesarray<string>required
      • generic_namesarray<string>required
      • submission_typestringrequired
      • submission_numberstringrequired
      • submission_class_codestringrequirednullable
      • submission_class_code_descriptionstringrequirednullable
      • submission_statusstringrequirednullable
      • submission_status_datestring (date)requirednullable
      • approval_datestring (date)requirednullable
      • review_prioritystringrequirednullable
      • source"openfda_drugsfda"default "openfda_drugsfda"
      • as_ofstring (date-time)required
  • metaMetarequiredResult-level provenance. ``source`` is a stable connector identifier (e.g. ``sec_edgar_companyfacts``); ``as_of`` is the freshest value-level ``as_of`` on the returned page, or ``None`` when the page is empty. Event-grained sources carry an aware datetime; date-grained sources (e.g. an SEC filing's report period) carry a plain date.
    • sourcestringrequired
    • as_ofstring (date-time) | string (date)nullable
  • paginationPaginationnullable
    • limitintegerrequired
    • has_morebooleanrequired
    • next_cursorstringnullable