Skip to main content

DailyMed — FDA SPL Drug Reference

Category: Clinical Tools
Node id: dailymed

Standards: clinical-reference, FDA-DailyMed

Query the US FDA DailyMed (Structured Product Labels) database for authoritative drug reference labels. Complements CIMA for non-Spain markets.

What it does​

  • Authoritative US drug labels (FDA Structured Product Labels)
  • Full label extraction by LOINC section: indications, dosage, contraindications, warnings, interactions, adverse reactions
  • NDC and SPL set_id lookup
  • Boxed warning detection

Use cases​

  • Retrieve dosing for a US-marketed medicine
  • Check FDA-approved indications and contraindications
  • Verify boxed warnings
  • Look up drugs by NDC code from a US prescription record

Runtime​

  • Performance tier: slow

Input ports​

NameTypeRequiredDescription
querytextNoDrug name, NDC, or SPL set_id

Output ports​

NameTypeRequiredDescription
labeljsonNoFull SPL label (null when status is not ok/partial)
sectionjsonNoSingle section (only on get_section)
candidatesjsonNoSearch candidates (only on search/disambiguation)
statustextNook | partial | not_found | unreachable | rate_limited | query_error
missing_sectionsjsonNoList of LOINC codes not returned by DailyMed (on partial)

Settings​

Basic​

SettingNameTypeRequiredDefaultAllowed valuesDescription
OperationoperationenumNolabellabel, search, get_section
QueryquerystringNoDrug name, NDC, or set_id (for label/search)
Query Typequery_typeenumNoname, ndc, setid
Set IDset_idstringNoSPL set_id (required for get_section)
SectionsectionstringNoLOINC code or alias (indications, dosage, contraindications, warnings, interactions, adverse_reactions, boxed_warning)

Advanced​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Bypass Cachebypass_cachebooleanNofalse

Errors​

CodeDescription
DAILYMED_USER_AGENT_REQUIREDDAILYMED_USER_AGENT env var is not set
QUERY_REQUIREDquery input or config is empty for label/search
SETID_SECTION_REQUIREDset_id and section are required for get_section

Runtime notes​

  • label output is null when status is not ok or partial — downstream nodes must check status before using label
  • DAILYMED_USER_AGENT env var must be set or node will fail on first Execute
  • partial status means some named SPL sections were unavailable; check missing_sections output
  • Spain-authorized medicines should use the CIMA node instead

See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.

Something unclear? Send documentation feedback by email.