Skip to main content

CIMA — AEMPS Drug Reference

Category: Clinical Tools
Node id: cima

Standards: clinical-reference, CIMA-AEMPS

Query the Spanish medicines regulator (AEMPS) CIMA database for authoritative drug reference cards from the ficha técnica.

What it does​

  • Authoritative drug reference from Spanish medicines regulator (AEMPS)
  • Full ficha técnica extraction: indications, posology, contraindications, interactions
  • Subsection extraction: renal/hepatic/elderly/pediatric dose adjustments
  • Supply problem flag per presentation (CN code)
  • AEMPS safety note (pharmacovigilance) history

Use cases​

  • Retrieve dosing information for a Spanish-authorized medicine
  • Check contraindications and interactions from the official ficha técnica
  • Verify if a drug has an active supply problem in Spain
  • Look up ATC classification for a brand-name drug

Runtime​

  • Performance tier: slow

Input ports​

NameTypeRequiredDescription
querytextNoDrug name, principio activo, ATC code, nregistro, or CN code

Output ports​

NameTypeRequiredDescription
cardjsonNoFull drug card (null when status is not ok/partial)
statustextNook | partial | not_found | disambiguation_required | unreachable | rate_limited | query_error
missing_sectionsjsonNoList of section IDs not returned by CIMA (on partial status)

Settings​

Basic​

SettingNameTypeRequiredDefaultAllowed valuesDescription
OperationoperationenumNodrug_carddrug_card, search, get_sectionCIMA operation to perform
Query Typequery_typeenumNoname, principio, atc, nregistro, cnHint for search parameter
NregistronregistrostringNoCIMA registration number (required for get_section)
SectionseccionenumNo4.1, 4.2, 4.3, 4.4, 4.5, 5.1, 5.2Ficha técnica section (for get_section)

Advanced​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Bypass Cachebypass_cachebooleanNofalseForce a fresh fetch from CIMA
Timeout (s)timeout_secondsnumberNo15Per-call budget in seconds

Errors​

CodeDescription
QUERY_REQUIREDquery input or config is empty for drug_card/search
NREGISTRO_SECCION_REQUIREDnregistro and seccion are required for get_section

Runtime notes​

  • card output is null when status is not ok or partial — downstream nodes must check status before using card
  • CIMA_USER_AGENT should identify your institution to AEMPS; unset falls back to a platform default rather than failing
  • partial status means some ficha técnica sections were unavailable; check missing_sections output
  • drug_card performs up to 12 parallel HTTP requests to CIMA; expect 250ms–2s cold-cache latency

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.