52_NDF_RT

Query NDF-RT (National Drug File Reference Terminology) via the NCI EVS REST API. Use when looking up drug mechanisms of action, physiological effects, pharmacologic classes, chemical structures, or d

SKILL.md

GitHub

NDF-RT Query Skill

Search NDF-RT concepts by drug name or NDF-RT code via the NCI EVS REST API. Auto-detects entity type by pattern:

Input Pattern Detected As Lookup Logic
N0000145918 NDF-RT code (N + 10 digits) direct concept GET
anything else free text full-text search endpoint

API

Function Input Returns
search(entity, limit) single entity string dict with entity, type, results
search_batch(entities, limit) list of entity strings dict[str, dict]
summarize(result, entity) search result dict + label compact multi-line text
to_json(result) search result dict list[dict]

Result dict structure

Each item in results contains:

Key Description
code NDF-RT concept code
name Preferred concept name
kind Concept kind (e.g. DRUG_KIND, DISEASE_KIND)
properties flat {type: value} property dict
roles list of {type, relatedCode, relatedName} role relationships
parents list of {code, name} ISA parent concepts
synonyms deduplicated list of synonym strings

Key NDF-RT relationship types (roles)

Role Meaning
has_MoA mechanism of action
has_PE physiological effect
has_EPC established pharmacologic class
may_treat indicated disease/condition
may_prevent preventable disease/condition
CI_with contraindicated with
has_Chemical_Structure chemical structure classification

Usage

See if __name__ == "__main__" block in 52_NDF_RT.py for runnable examples covering: drug name search, code lookup, batch search, JSON output, and root concept listing.

Data

  • Source: NCI EVS REST API (https://api-evsrest.nci.nih.gov/api/v1)
  • Terminology: ndfrt
  • Auth: none required
  • Rate limits: not documented; use reasonable request spacing
  • Maintainer: U.S. Department of Veterans Affairs / NCI Enterprise Vocabulary Services