{"openapi":"3.1.0","info":{"title":"MediSearch Evidence API","summary":"Source search over medical literature, guidelines and drug labels.","description":"\nSearch peer-reviewed literature, clinical practice guidelines and drug labels.\nResponses contain ranked source passages with citation metadata; the API does\nnot generate text. The same search is available as an MCP server at\n`POST /mcp`. Documentation: [/](/) · Filter reference: [/reference](/reference).\n","termsOfService":"https://medisearch.io/terms","contact":{"name":"MediSearch","url":"https://medisearch.io/","email":"founders@medisearch.io"},"version":"1.0.0","x-logo":{"url":"https://medisearch.io/favicon.ico","altText":"MediSearch"}},"servers":[{"url":"https://evidence.medisearch.io"}],"paths":{"/healthz":{"get":{"tags":["Reference"],"summary":"Liveness probe","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Healthz Healthz Get"}}}}}}},"/v1/filters":{"get":{"tags":["Reference"],"summary":"Filter vocabularies","description":"Every value accepted by `filters` in `POST /v1/evidence/search`, including all organization codes. No authentication required.","operationId":"list_filters_v1_filters_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilterOptionsResponse"}}}}}}},"/v1/filters/organizations":{"get":{"tags":["Reference"],"summary":"Search organization codes","description":"Look up values for `filters.organizations`. `q` matches code or name substrings (case- and accent-insensitive). No authentication required.","operationId":"search_organizations_v1_filters_organizations_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Code or name substring.","examples":["cardio"],"title":"Q"},"description":"Code or name substring."},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2},{"type":"null"}],"description":"Country code, e.g. `DE`.","title":"Country"},"description":"Country code, e.g. `DE`."},{"name":"region","in":"query","required":false,"schema":{"anyOf":[{"enum":["global","north_america","south_america","europe","asia","africa","oceania"],"type":"string"},{"type":"null"}],"description":"Region id.","title":"Region"},"description":"Region id."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/evidence/search":{"post":{"tags":["Evidence"],"summary":"Search for cited medical sources","description":"Returns `max_results` sources ranked by relevance (fewer only when fewer publications match the filters). Each result is one publication with its best-matching passage.","operationId":"evidence_search_v1_evidence_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceSearchResponse"}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded (see Retry-After).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Retrieval backend unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"504":{"description":"Search timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}]}},"/mcp":{"post":{"tags":["MCP"],"summary":"MCP JSON-RPC endpoint","description":"Streamable HTTP transport, stateless, JSON responses. Body: a JSON-RPC 2.0 request or batch. Methods: `initialize`, `ping`, `tools/list`, `tools/call`. Tools: `search_medical_evidence`, `list_evidence_filter_options`. Notifications return `202`.","operationId":"mcp_post_mcp_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"},"examples":{"initialize":{"value":{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"host","version":"1.0"}}}},"tools/list":{"value":{"jsonrpc":"2.0","id":2,"method":"tools/list"}},"tools/call":{"value":{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_medical_evidence","arguments":{"question":"Does vitamin D prevent respiratory infections?","max_results":5,"study_types":["systematic_review"]}}}}}}},"required":true},"responses":{"200":{"description":"JSON-RPC response object (or batch array).","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}}},"202":{"description":"Notification accepted; no body."},"400":{"description":"Malformed JSON-RPC payload."},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}]}}},"components":{"schemas":{"CountryEntry":{"properties":{"code":{"type":"string","title":"Code"},"name":{"type":"string","title":"Name"},"region":{"type":"string","title":"Region"}},"type":"object","required":["code","name","region"],"title":"CountryEntry"},"DrugInformationFilters":{"properties":{"countries":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":50},{"type":"null"}],"items":{"type":"string","enum":["US","CA","MX","GT","HN","SV","NI","CR","PA","BZ","CU","DO","PR","JM","HT","TT","BB","BS","AG","LC","GD","VC","KN","DM","BR","AR","CL","CO","PE","VE","EC","UY","PY","BO","GY","SR","UK","IE","FR","DE","AT","CH","BE","NL","LU","ES","PT","IT","GR","MT","CY","AD","SM","SE","DK","NO","FI","IS","EE","LV","LT","PL","CZ","SK","HU","RO","BG","HR","RS","SI","BA","ME","MK","AL","MD","UA","BY","XK","RU","GE","AM","TR","JP","CN","KR","TW","HK","MO","TH","VN","ID","MY","PH","SG","MM","KH","LA","BN","IN","PK","BD","LK","NP","BT","MV","AZ","KZ","UZ","TM","KG","TJ","MN","IL","SA","AE","IR","IQ","JO","LB","SY","QA","KW","BH","OM","YE","PS","EG","MA","TN","DZ","LY","SD","ZA","NG","KE","GH","ET","TZ","UG","SN","CM","CI","RW","MZ","ZW","BW","MW","NA","ZM","MG","AO","CD","ML","BF","NE","TD","SO","MU","AU","NZ","FJ","PG"]},"title":"Countries","description":"Drug labels approved in these countries (e.g. `US` for FDA labels). Same codes as `guideline.countries`.","examples":[["US"]]}},"additionalProperties":false,"type":"object","title":"DrugInformationFilters","description":"Filters that apply only to drug labels and monographs."},"ErrorResponse":{"properties":{"error":{"type":"string","title":"Error","description":"Machine-readable error code."},"detail":{"title":"Detail","description":"Human-readable explanation."}},"type":"object","required":["error"],"title":"ErrorResponse"},"EvidenceFilters":{"properties":{"year_start":{"anyOf":[{"type":"integer","maximum":2100.0,"minimum":1900.0},{"type":"null"}],"title":"Year Start","description":"Earliest publication year, inclusive.","examples":[2018]},"year_end":{"anyOf":[{"type":"integer","maximum":2100.0,"minimum":1900.0},{"type":"null"}],"title":"Year End","description":"Latest publication year, inclusive.","examples":[2026]},"source_types":{"anyOf":[{"items":{"type":"string","enum":["guideline","research_article","drug_information"]},"type":"array"},{"type":"null"}],"title":"Source Types","description":"Document kinds to search. Omit for all. `guideline`: clinical practice guidelines and consensus statements from medical societies and health agencies. `research_article`: PubMed / PubMed Central literature. `drug_information`: drug labels and regulatory drug summaries.","examples":[["guideline"],["guideline","research_article"]]},"study_types":{"anyOf":[{"items":{"type":"string","enum":["systematic_review","randomized_trial","primary_research","case_report","other"]},"type":"array"},{"type":"null"}],"title":"Study Types","description":"Study designs for `research_article` results. Omit for all. Does not exclude guidelines or drug information; combine with `source_types: [\"research_article\"]` for research only.","examples":[["systematic_review","randomized_trial"]]},"specialties":{"anyOf":[{"items":{"type":"string","enum":["family_medicine","internal_medicine","hospital_medicine","urgent_care","pediatrics","geriatrics","preventive_medicine","public_health","allergy_immunology","cardiology","dermatology","endocrinology","gastroenterology","genetics","hematology","infectious_disease","nephrology","neurology","nuclear_medicine","oncology","pulmonology","rheumatology","sleep_medicine","sports_medicine","urology","general_surgery","cardiac_surgery","colon_rectal_surgery","hand_surgery","neurological_surgery","oral_maxillofacial_surgery","orthopedic_surgery","pediatric_surgery","plastic_surgery","surgical_oncology","thoracic_surgery","transplant_medicine","trauma_surgery","vascular_surgery","obstetrics_gynecology","maternal_fetal_medicine","neonatology","reproductive_endocrinology","womens_health","psychiatry","addiction_medicine","emergency_medicine","critical_care_medicine","pain_medicine","hospice_palliative_medicine","radiology","radiation_oncology","pathology","pharmacology","anesthesiology","ophthalmology","otolaryngology","orthopedics","physical_medicine_rehabilitation","dentistry","nutrition","podiatry","veterinary"]},"type":"array"},{"type":"null"}],"title":"Specialties","description":"Documents tagged with any of these specialties. Untagged documents are excluded, so this can drop relevant sources.","examples":[["cardiology"],["pediatrics","infectious_disease"]]},"languages":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":50},{"type":"null"}],"items":{"type":"string","enum":["en","fr","de","nl","it","es","pt","ca","gl","eu","sv","da","no","fi","is","pl","cs","sk","hu","ro","bg","hr","sr","sl","bs","sq","mk","mt","uk","be","lt","lv","et","el","tr","ja","zh","ko","hi","bn","ta","te","ur","ne","si","th","vi","id","ms","tl","my","km","lo","ar","fa","he","ru","ka","hy","az","kk","uz","am","sw","af"]},"title":"Languages","description":"Document languages (ISO 639-1). Omit to search all languages. Questions may be in any language regardless of this filter.","examples":[["en"],["es","pt"]]},"organizations":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":50},{"type":"null"}],"items":{"type":"string","enum":["WHO","PAHO","Cochrane","IDF","KDIGO","WFNS","WGA/WGO","WONCA","WAO","WFH","ISH","ISTH","ILAE","ISHLT","TTS","IUIS","IASP","IGCS","SIOG","MASCC","ISSM","ISTM","ICM","ISAKOS","AO Foundation","AO Spine","SSC","GOLD","GINA","FIGO","IARC","IAS","WFSA","WPA","WSES","ISPD","ISUOG","ISN","IFSO","ICS","ISPAD","IPNA","IPCRG","ISBI","IFFS","ISS/SIC","WFSBP","WASOG","IAPB","IHPBA","ISCVS","ISSVA","IPA","IPEG","ICRS","ICAETR","SICOT","IPPF","IDF/WDF","ERAS","ELSO","NIH","NCI","NHLBI","NIMH","NIDDK","NIAID","CDC","FDA","AHRQ","USPSTF","VA/DoD","CMS","SAMHSA","HRSA","OASH","USPHS","EPA-US","IHS","ATSDR","BARDA","PCORI","NQF","TJC","ACIP","AHA","ACC","HRS","HFSA","SCAI","STS","SVS","AVF","ASCO","NCCN","ACS-Onc","ASTRO","SNO","SSO","COG","ATS","CHEST/ACCP","SCCM","ACCM","AGA","ACG","ACCP","ASGE","AASLD","NASPGHAN","IDSA","SHEA","HIVMA","PIDS","ASM","APIC","ASTMH","ADA","AACE","ES","ATA","ASN","AAN","AANS","CNS","AES","AHS","MDA","APA","AACAP","ASAM","ACOG","SMFM","ASRM","SGO","ASCCP","NAMS","AAP","ACS","SAGES","EAST","WTA","AAST","ASMBS","APSA","AAOS","AOSSM","ASES","OTA","AOFAS","ACR","ACR-Rad","SIR","RSNA","SNMMI","AAD","AAO","ASCRS","AAO-HNS","ARS","AUA","AAAAI","ACEP","NAEMSP","ASA","ASRA","ASH","AST","ASTS","AGS","AMDA","AAFP","ACP","AASM","AND","ASPEN","CAP","ACMG","NSGC","AAHPM","APHA","AAPM&R","ACRM","ACOEM","ACPM","WHS","ACSM","AMSSM","NAME","SHM","AABB","SITC","ACMT","ABA","ASHP","AANEM","ASDS","ASPS","AATS","ACAAI","ASNR","ASNC","SAEM","AAPM","APhA","ASHG","ISMP","NKF","ALA","FACT","ACVPR","SCA","SNIS","ASIPP","AAGL","SGS","AUGS","AHNS","AOS","ANS","ASCRS-Colon","AHPBA","ASPHO","SWOG","ECOG-ACRIN","NRG","ARS-RadOnc","NASPHV","CFF","WMS","AAP-Perio","CCS","CMA","CTFPHC","SOGC","CDA","CTS","CADTH","CAGC","CSN","CPS","CFPC","CAR","CAGS","COA","CUA","CDA-Derm","CSACI","CAEP","CAG","PHAC","INESSS","CSIM","COS-Ophth","OC","NACI","NICE","SIGN","BTS","BSG","BASL","BOA","RCOG","RCP","RCS","RCPCH","RCPsych","RCGP","RCR","RCPath","RCOphth","BASHH","BHIVA","BAD","BSACI","BSR","BAUS","BGS","BSPED","BSH","BSGM","PHE/UKHSA","JRCALC","BAPM","RCOA","SCTS","ACPGBI","ABS-UK","BOMSS","BSGE","AA-UK","PCRS-UK","BCS","BAETS","SfE-UK","BSS","BOFAS","BAPS","BAPRAS","VSGBI","BNOS","ABCD","UKKA","BSI","BIS","FSRH","NOGG","BHS","ESC","EACTS","EHRA","ESVS","ESMO","ESSO","ESTRO","ENETS","SIOPE","EULAR","ERS","EASL","ESGE","ECCO","ESPGHAN","UEG","ESCMID","EACS","EUCAST","EAACI","EAU","ESHRE","ESGO","EAN","EANM","EPA","ESPEN","EUGMS","ERA","ESE","EHA","EBMT","ESA","ESICM","ESPID","ESPE","EAP","EADV","ESCRS","EURETINA","ESSKA","EFORT","ESES","EAES","EHS","ESHG","EWMA","EMA","EFSA","EAS","ESOT","ESSM","EANO","EANS","ESPNIC","ESUR","ESTS","ESCP","ETA","EAPC","ESPR","EPNS","EuroELSO","EURORDIS","EFCNI","ESR","CIRSE","ESNR","ESGAR","ESO","ECTRIMS","ECNP","EUSEM","EAPCCT","EFIM","EASO","ESRA","EFIC","ESP","EFLM","ESID","ECDC","EUPHA","EACPT","ECFS","ECTS","IOF","EBJIS","EPOS","SECEC-ESSSE","ESGE-Surg","EUGA","EDQM","ESTES","ESRS","EMCDDA/EUDA","EASOM","ECLM","EHNS","EUSOMA","EVF","ECTMIH","EDTNA/ERCA","EMN","EHF","EACVI","EUSOBI","HAS","ANSM","AWMF","IQWiG","G-BA","RKI","AIFA","SNLG","GuiaSalud","AEMPS","SBU","KCE","ZIN","NHG","SST","THL","FOPH","HIQA","HSE","HDIR","SLV","AOTMiT","DGIM","DIVI","DEGAM","SRLF","SPILF","AFEF","SEMI","SEMICYUC","SIMI","SIGG","SIOT","NVK","ÖGARI","SSAI","BfArM","BÄK","DKG","INCa","ISS-Italy","RIVM","CBG-MEB","IKNL","FAMHP/AFMPS","BASG","Swissmedic","SoS","FHI","NoMA","DKMA","Fimea","HPRA","INFARMED","DGS-PT","EOF","ANM-RO","HALMED","ALIMS","OGYÉI","JAZMP","ZVA","VVKT","Ravimiamet","LYFJASTOFNUN","SFC","SFNDT","SFR","SNFGE","SPLF","SFD","SFO","SFAR","SFP","CNGOF","DGK","DGHO","DDG","DGP","DGVS","DGN","DGGG","DGU","DGOOC","DGAI","DGRh","DGKJ","SIAARTI","SIC","SIGE","SID-Italy","AIOM","SIN-Italy","SIR-Italy","SEC","SEPAR","SER","SEEN","SEOM","SEGO","SEN","AEP","AEEH","NVVC","NIV","NVR","NVOG","NVU","BSC","BVIKM","OGK","OGR","OEGGG","SGK/SSC","SGR/SSR","DCS","DES","NCS","FCS","SCS","SweS","Duodecim","PTK","PTP","PTD-Poland","PTG","PTO","PTN-Poland","PTR-Poland","PTN-Neuro","PTE","CLS-JEP","CKS","SUKL","CGS","CDS-Czech","CNS-Czech","SLS","SKS","SDS","SNS","MKT","MOTESZ","MDT","SRC","SRD","BKD","BMA","HKD","HLZ","UKS","SLD","ZZS","UAC","MOH-Ukraine","HCS","HES","SPC-Portugal","SPR","LKB","LKD","ECS-Estonia","SFN-FR","SFMU","SFETD","SFE","SFHH","SFH-FR","SFDermato","SFGG","AFC","AFU","SFR-Rad","SFNR","SFMV","SFPT","SFORL","SFCO","SFNEP","SFPO","SFCPCV","GRIO","SFRMS","FFP","SFIPP","DGCH","DGE-Endo","DGEM","DGG","DGHM","DGOU","DGNC","DGHNO-KHC","DGfN","DGS-DE","DOG","DDG-Derm","DGPPN","DGI-DE","DGG-Vasc","DGPM","DGRad","ADO","AIO","AGO","GPOH","DGTHG","SIN-Neuro","SIE-IT","SIGO","SIU-IT","SIP-IT","SIMEU","SIRM","SIOeChCF","SIDeMaST","AIGO","SIChER","SIMFER","SICI-GISE","SIP-Sport","SIPPS","SIMG","SENeu","SEAIC","AEU","SEDAR","SEHH","SEMES","SEGG","SECOT","AEC","SEIMC","SEH-LELHA","SED-Pain","SEO-ES","SEORL-CCC","AEDV","SEDO","SECPRE","semFYC","NVMDL","NVALT","NVN-NL","NVvP","NVDV","NOG","NOV","NVA-NL","NVvH","NVKNO","NVvR","NVvH-Hema","NVKC","BSMO","BHS-BE","BVN-BE","BVGE/SBGE","BVU/SBU-BE","BVP/SBP-BE","BNvN/SBNC","BSSD/BVSD","Domus Medica","SSMG","ÖGN","ÖGIM","ÖGP","ÖDG","ÖGU","ÖGH-Onc","ÖGCH","ÖGD","ABCSG","ÖGG-Gastro","ÖGNM","ÖGPP","SGGG/SSGO","SGAIM/SSMI","SGP-CH/SSP","SGAR/SSAR","SNG/SSN","SGMO/SSOM","SGU/SSU","SGDV","SGG/SSG-CH","SGNeph","SGH/SSH","SGPP/SSPP","SGNOR/SSMUS","SFI-SE","SFOG","SFR-SE","SGF-SE","SNF-SE","SPF-SE","SOF","SFAI","NEF-NO","NGF-NO","NGF-Gyn","NNF-NO","NRF","NOF-NO","NIF","DGS-DK","DSOG","DRKS","DNL","DOS","DSTH","DSKM","DASAIM","DSKO","FLS","SPR-FI","SGY-FI","SLL","LSI","LSI-Card","PTGO-PL","PTU-PL","PTA-PL","PTHiT","PTChO","PTGC","PTOiHN","COS-CZ","CRS-CZ","CPFS","CNeuS","COnkS","CUS-CZ","CHS-CZ","SPS-SK","SRS-SK","SOS-SK","SNeuS","MNT","MOT-HU","MRT-HU","MGyT","MNeuT","MPT","SRR-RO","SRN-RO","SRGH","SRO-RO","SRMFR","SRP-RO","BGSG","BGN-BG","BGR-BG","BGO","BGNeu","HGD","HRD-HR","HND","HOD","GDS","RDS-RS","UNS-RS","DES-RS","SZD","SDK-SI","SDG-SI","SDN-SI","AMNU","UAN-UA","UGS-UA","UAR-UA","USEM","HGS-GR","HRS-GR","HSO-GR","HNS-GR","HPS-GR","HUS-GR","SPGH","SPN-PT","SPEDM","SPO-PT","SPP-PT","SPN-Neuro","SPDerm","OM-PT","LAB","LGEA","LRA-LV","LGD-LT","LRD-LT","LND-LT","EAL-EE","ERFS","EGAS","ICGP","RCPI","RCSI-IE","ISN-IE","INS","ISR-IE","NCCP-IE","IMO","SFGM-TC","SEAP","GTH","SOLACI","ALAD","SLANH","FLASOG","SIAC","CENETEC","IMSS","SSA-Mexico","SMC","CONITEC","ANVISA","SBC","SBD","SBOC","SBPT","SBH","SBR","SBEM","ABN","FEBRASGO","SBP","SBU-Brazil","SAC","SAD","SAP","SADI","SAR","IETS","SCC","ACE-Colombia","MINSAL","SOCHICAR","SOCHOG","MINSA-Peru","SPC","ALAT","SOBED","AMB","SBI-ID","AMIB","SBGG","SMNE","COMEGO","FAC","SATI","SAN","ACIN","SVN","SVC","MSP-EC","MINSAP","JCS","JSGE","JGA","JDS","JRS","JSH","JSCO","JSMO","JOA","JSUM","JSN","JDA","JPS","JSES","JSGO","JSA","JSICM","JSS","JUA","JNS","JSNP","JSHCT","Minds","JES","JAAM","JSTH","JSDR","JRS-Rheum","CMA-China","CSC","CSCO","NHC-China","CFDA/NMPA","COGA","CDS","CSN-China","CSNO","COA-China","CSA-China","CSCCM","CMDA","CACA","CRS-China","COS-China","CSBrS","KSC","KDA","KSCP","KMA","KCDC/KDCA","KCR","KASL","KSGE","KACO","KSN","KNS","KSBMR","KSSO","KSA-Anes","KSGO","CSI","ICMR","API","RSSDI","IAP","FOGSI","IMA","IADVL","ISN-India","NSI","ASI","IOA","ISCCM","IACS","ISG","IRA","TMA","TSIM","TSOC","TOS","TRA","TSN-TW","HSA-SG","MOH-SG","AMS-SG","RCT","MOH-MY","MMA","RTCOG","TCVS","TSN-TH","NHMRC","TGA","CSANZ","TSANZ","RANZCOG","RACP","RACS","RANZCR","RANZCP","GESA","ARA","NHFA","Cancer Council","ANZSBT","ANZCA","KHA","DA-AU","ACSQHC","AOA","USANZ","BPACNZ","PHARMAC","HQSC","APLAR","APASL","APSTH","APHRS","APSC","APSDE","AOFOG","APSR","PASCAR","AORTIC","SAHCS","SAMA","SASOG","HPCSA","SAGES-Africa","SASA","SARS","NMA","NSOGT","KMA-Kenya","ESC-Egypt","MoHP-Egypt","AFEM","ASLM","ASA-SA","SAOA","SATS","GMA","GHS","MAT","EMA-ET","FMOH-ET","IMA-Israel","ICS-Israel","SFDA","SHA","SCFHS","DOH-UAE","DHA","HAAD","MOH-Iran","ICS-Iran","TCS","TTD","JRMS","TND","TGOD","JMA","LOS","SGES","SSNEPH","ESN-Egypt","ESG-Egypt","RSC","RAE","RGA","RPO","RRO","MOH-RU","RSCH","RSN","PMA","CPSP","PCS-PK","PES-PK","PSN","PMRC","BMA-BD","BCS-BD","BIRDEM","SLMA","CCSL","SLCP","SLCOG","NMA-NP","NSC-NP","PHA","PCS-PH","PCP","PMA-PH","PHSG","IDI","PERKI","PDPI","PERKENI","BPOM","PERNEFRI","VMA","VSC","MOH-VN","CyMA","MOPH-CY","MAM","MFH-MT","AMMD","MS-LU","Landspitali","LJKCG","MOH-ME","LKM","MOH-MK","MHSP-AL","UMT","MSMPS-MD","AMDM","MOH-BY","MSH-XK","KDC"]},"title":"Organizations","description":"Issuing organizations. Accepts codes (case-insensitive) or exact full names; look up codes with `GET /v1/filters/organizations`. Research articles have no issuing organization, so this effectively restricts results to guidelines and drug information.","examples":[["WHO","NICE"],["DGK"]]},"guideline":{"$ref":"#/components/schemas/GuidelineFilters","description":"Filters applied to guidelines only."},"drug_information":{"$ref":"#/components/schemas/DrugInformationFilters","description":"Filters applied to drug information only."}},"additionalProperties":false,"type":"object","title":"EvidenceFilters","description":"Retrieval filters. All optional; filters combine with AND, values\nwithin one filter with OR."},"EvidenceSearchRequest":{"properties":{"question":{"type":"string","maxLength":2000,"minLength":3,"title":"Question","description":"The question to search for, in any language (most indexed literature is English). Must be self-contained: resolve follow-ups into a full question and name the population, intervention, comparison and outcome when known. A focused question retrieves better than a long case description.","examples":["Does vitamin D supplementation prevent respiratory infections in adults?"]},"rerank_query":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Rerank Query","description":"Optional self-contained version of the question, used for the search instead of `question`, which is then echoed back. Use when `question` holds a user's literal follow-up wording."},"topic_query":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Topic Query","description":"Optional topic of the question: the condition and the decision asked about, phrased like a guideline or review title, without patient specifics. Helps surface guidelines and reviews on the topic. Omit when no guideline or review would address the question.","examples":["pulmonary embolism anticoagulation guideline recommendations"]},"dense_queries":{"items":{"type":"string"},"type":"array","maxItems":3,"title":"Dense Queries","description":"Optional, up to 3 alternative phrasings (lay/clinical, brand/generic) or sub-questions that widen the search. Results are still matched to the question, so the main ask belongs there.","examples":[["GLP-1 receptor agonist obesity randomized trial"]]},"keyword_queries":{"items":{"type":"string"},"type":"array","maxItems":3,"title":"Keyword Queries","description":"Optional, up to 3 short exact terms to match, in English: drug and brand names, gene symbols, trial acronyms, named scores. Results are still matched to the question.","examples":[["STEP 1 trial semaglutide 2.4 mg"]]},"max_results":{"type":"integer","maximum":30.0,"minimum":1.0,"title":"Max Results","description":"Number of sources to return, each a different publication, ordered by relevance. Fewer only when fewer publications match the filters.","default":10},"passage_chars":{"type":"integer","maximum":6000.0,"minimum":0.0,"title":"Passage Chars","description":"Maximum passage length in characters, cut at a sentence boundary; `0` omits passages.","default":1200},"filters":{"$ref":"#/components/schemas/EvidenceFilters","description":"Retrieval filters; vocabularies at `GET /v1/filters`."}},"additionalProperties":false,"type":"object","required":["question"],"title":"EvidenceSearchRequest","description":"A single evidence search.","examples":[{"filters":{"source_types":["research_article","guideline"],"study_types":["systematic_review","randomized_trial"],"year_start":2020},"max_results":8,"question":"Is semaglutide effective for weight loss in adults without diabetes?"},{"filters":{"guideline":{"countries":["US","UK"],"include_reference_bodies":true},"source_types":["guideline"]},"max_results":6,"question":"First-line treatment of hypertension in adults"}]},"EvidenceSearchResponse":{"properties":{"request_id":{"type":"string","title":"Request Id"},"question":{"type":"string","title":"Question"},"rerank_query":{"type":"string","title":"Rerank Query"},"result_count":{"type":"integer","title":"Result Count"},"latency_ms":{"type":"integer","title":"Latency Ms"},"filters_applied":{"$ref":"#/components/schemas/EvidenceFilters"},"results":{"items":{"$ref":"#/components/schemas/EvidenceSource"},"type":"array","title":"Results"}},"type":"object","required":["request_id","question","rerank_query","result_count","latency_ms","filters_applied","results"],"title":"EvidenceSearchResponse"},"EvidenceSource":{"properties":{"rank":{"type":"integer","title":"Rank","description":"1-based rank in this response."},"relevance_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Relevance Score","description":"Relevance in [0, 1]; higher is more relevant."},"source_type":{"type":"string","enum":["guideline","research_article","drug_information"],"title":"Source Type"},"document_types":{"items":{"type":"string"},"type":"array","title":"Document Types","description":"Corpus document-type labels (e.g. `systematic_review`, `guideline`)."},"title":{"type":"string","title":"Title"},"url":{"type":"string","title":"Url","description":"Canonical link to the publication."},"deep_link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deep Link","description":"Same link with a text fragment (`#:~:text=`) that highlights the cited passage in browsers that support it."},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"},"authors":{"items":{"type":"string"},"type":"array","title":"Authors"},"journal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Journal","description":"Journal, publisher or issuing body."},"organization":{"anyOf":[{"$ref":"#/components/schemas/Organization"},{"type":"null"}],"description":"Issuing organization for guidelines and drug labels."},"passage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Passage","description":"The relevant passage from the document (trimmed to `passage_chars`)."},"passage_kind":{"anyOf":[{"type":"string","enum":["passage","table","figure","list"]},{"type":"null"}],"title":"Passage Kind","description":"Where the passage lives in the document: prose, table, figure caption or list."},"section":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Section","description":"Section path of the passage inside the document, outermost first."},"citation":{"type":"string","title":"Citation","description":"Ready-to-use plain-text citation: Authors (Year). Title. Journal. URL"}},"type":"object","required":["rank","source_type","title","url","citation"],"title":"EvidenceSource","description":"One cited source: a passage from a guideline, article or drug label."},"FilterOptionsResponse":{"properties":{"vocabulary_version":{"type":"string","title":"Vocabulary Version"},"source_types":{"items":{"$ref":"#/components/schemas/VocabularyValue"},"type":"array","title":"Source Types"},"study_types":{"items":{"$ref":"#/components/schemas/VocabularyValue"},"type":"array","title":"Study Types"},"specialties":{"items":{"type":"string"},"type":"array","title":"Specialties"},"languages":{"items":{"$ref":"#/components/schemas/LanguageEntry"},"type":"array","title":"Languages"},"countries":{"items":{"$ref":"#/components/schemas/CountryEntry"},"type":"array","title":"Countries"},"regions":{"additionalProperties":{"type":"string"},"type":"object","title":"Regions","description":"Region id -> label."},"reference_bodies":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Reference Bodies","description":"Organization codes added by `guideline.include_reference_bodies`, grouped as `us` and `eu_uk`."},"organizations":{"items":{"$ref":"#/components/schemas/OrganizationEntry"},"type":"array","title":"Organizations"},"limits":{"additionalProperties":{"type":"integer"},"type":"object","title":"Limits"}},"type":"object","required":["vocabulary_version","source_types","study_types","specialties","languages","countries","regions","reference_bodies","organizations","limits"],"title":"FilterOptionsResponse"},"GuidelineFilters":{"properties":{"countries":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":50},{"type":"null"}],"items":{"type":"string","enum":["US","CA","MX","GT","HN","SV","NI","CR","PA","BZ","CU","DO","PR","JM","HT","TT","BB","BS","AG","LC","GD","VC","KN","DM","BR","AR","CL","CO","PE","VE","EC","UY","PY","BO","GY","SR","UK","IE","FR","DE","AT","CH","BE","NL","LU","ES","PT","IT","GR","MT","CY","AD","SM","SE","DK","NO","FI","IS","EE","LV","LT","PL","CZ","SK","HU","RO","BG","HR","RS","SI","BA","ME","MK","AL","MD","UA","BY","XK","RU","GE","AM","TR","JP","CN","KR","TW","HK","MO","TH","VN","ID","MY","PH","SG","MM","KH","LA","BN","IN","PK","BD","LK","NP","BT","MV","AZ","KZ","UZ","TM","KG","TJ","MN","IL","SA","AE","IR","IQ","JO","LB","SY","QA","KW","BH","OM","YE","PS","EG","MA","TN","DZ","LY","SD","ZA","NG","KE","GH","ET","TZ","UG","SN","CM","CI","RW","MZ","ZW","BW","MW","NA","ZM","MG","AO","CD","ML","BF","NE","TD","SO","MU","AU","NZ","FJ","PG"]},"title":"Countries","description":"Guidelines issued for these countries. Also matches guidance issued for the country's region (e.g. `DE` matches EU-wide guidelines) and by international bodies (e.g. WHO, Cochrane, GOLD, KDIGO). Codes are case-insensitive; `GB` is an alias of `UK`.","examples":[["US"],["UK","IE"]]},"include_reference_bodies":{"type":"boolean","title":"Include Reference Bodies","description":"With `countries`, also match guidelines from the US and EU/UK reference bodies listed in `GET /v1/filters` (`reference_bodies`).","default":false}},"additionalProperties":false,"type":"object","title":"GuidelineFilters","description":"Filters that apply only to clinical practice guidelines."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LanguageEntry":{"properties":{"code":{"type":"string","title":"Code"},"name":{"type":"string","title":"Name"}},"type":"object","required":["code","name"],"title":"LanguageEntry"},"Organization":{"properties":{"code":{"type":"string","title":"Code","description":"Short code, e.g. `WHO`, `NICE`, `ESC`."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Full organization name when known."}},"type":"object","required":["code"],"title":"Organization"},"OrganizationEntry":{"properties":{"code":{"type":"string","title":"Code","description":"Value to pass in `filters.organizations`."},"name":{"type":"string","title":"Name"},"group":{"type":"string","title":"Group","description":"Registry group id, e.g. `united_kingdom`."},"group_label":{"type":"string","title":"Group Label"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country code; null for multinational bodies."},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region","description":"`global`, `north_america`, `europe`, ..."}},"type":"object","required":["code","name","group","group_label"],"title":"OrganizationEntry"},"OrganizationSearchResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Number of matches before `limit`."},"organizations":{"items":{"$ref":"#/components/schemas/OrganizationEntry"},"type":"array","title":"Organizations"}},"type":"object","required":["total","organizations"],"title":"OrganizationSearchResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VocabularyValue":{"properties":{"value":{"type":"string","title":"Value"},"description":{"type":"string","title":"Description"}},"type":"object","required":["value","description"],"title":"VocabularyValue"}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API key","description":"`Authorization: Bearer <api_key>`"},"ApiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","description":"`X-API-Key: <api_key>`"}}},"tags":[{"name":"Evidence","description":"Source search."},{"name":"Reference","description":"Filter vocabularies and health."},{"name":"MCP","description":"Model Context Protocol endpoint (JSON-RPC 2.0)."}],"x-mcp":{"transport":"streamable-http","endpoint":"https://evidence.medisearch.io/mcp","protocolVersions":["2025-06-18","2025-03-26","2024-11-05"],"tools":["search_medical_evidence","list_evidence_filter_options"]}}