{"openapi":"3.1.0","info":{"title":"İlaçAtlas — Clinical Decision Support & Medicine Database","description":"Relational clinical reference, universal generic brand explorer, and structured official TİTCK document repository. This is a reference that quotes documents: it does not diagnose, prescribe or decide, and an empty field means the source document is silent rather than unrestricted.","termsOfService":"https://ilacatlas.com/api-kullanim-sartlari","license":{"name":"Belgeler TİTCK'ya aittir; erişim şartları API Kullanım Şartları'nda","url":"https://ilacatlas.com/api-kullanim-sartlari"},"version":"2.2.0"},"servers":[{"url":"https://ilacatlas.com","description":"Production"}],"paths":{"/api/clinical/search":{"get":{"summary":"Clinical Search","operationId":"clinical_search","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}},{"name":"exact","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Exact"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClinicalSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/active-ingredients":{"get":{"summary":"Get Active Ingredients","operationId":"active_ingredients","parameters":[{"name":"search","in":"query","required":false,"schema":{"type":"string","default":"","title":"Search"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/active-ingredients/{ingredient}":{"get":{"summary":"Get Ingredient Preparations","operationId":"ingredient_preparations","parameters":[{"name":"ingredient","in":"path","required":true,"schema":{"type":"string","title":"Ingredient"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/icd10/search":{"get":{"summary":"Icd10 Search","description":"Diagnoses matching a typed phrase, in the words a clinician uses.","operationId":"icd10_search","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"leaf_only","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Leaf Only"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/icd10/chapters":{"get":{"summary":"Icd10 Chapters","operationId":"icd10_chapters","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/icd10/common":{"get":{"summary":"Icd10 Common","description":"Ek B Liste 5 -- the 300 conditions morbidity reporting is built on.","operationId":"icd10_common","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/icd10/{icd10_code}/medicines":{"get":{"summary":"Icd10 Medicines","description":"Medicines whose KÜB 4.1 names this diagnosis, each with the sentence.\n\nThere is no published ICD-to-medicine mapping in Turkey and no honest way\nto invent one, so the answer is evidence rather than assertion: every row\ncarries the sentence of its own indication section that matched, and\nwhether TİTCK's own ATC code for that medicine lands where this chapter\nwould lead. `agreement` narrows to one of the three verdicts.","operationId":"icd10_medicines","parameters":[{"name":"icd10_code","in":"path","required":true,"schema":{"type":"string","title":"Icd10 Code"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"agreement","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(uyumlu|beklenmedik|belirsiz)$"},{"type":"null"}],"title":"Agreement"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiagnosisMedicinesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/icd10/{code}":{"get":{"summary":"Icd10 Detail","operationId":"icd10_detail","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/groups":{"get":{"summary":"Get Clinical Groups","description":"Clinical groups with how many medicines each resolves to.","operationId":"clinical_groups","parameters":[{"name":"include_empty","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Empty"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/groups/match":{"get":{"summary":"Match Clinical Group","description":"Which groups a typed phrase names, so the search box can suggest one.","operationId":"match_clinical_group","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":5,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/groups/{slug}":{"get":{"summary":"Get Clinical Group","operationId":"clinical_group","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/medicines":{"get":{"summary":"Get Medicines","operationId":"medicines","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"","title":"Query"}},{"name":"atc","in":"query","required":false,"schema":{"type":"string","default":"","title":"Atc"}},{"name":"form","in":"query","required":false,"schema":{"type":"string","default":"","title":"Form"}},{"name":"manufacturer","in":"query","required":false,"schema":{"type":"string","default":"","title":"Manufacturer"}},{"name":"prescription","in":"query","required":false,"schema":{"type":"string","default":"","title":"Prescription"}},{"name":"group","in":"query","required":false,"schema":{"type":"string","default":"","title":"Group"}},{"name":"ingredient","in":"query","required":false,"schema":{"type":"string","default":"","title":"Ingredient"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","default":"","title":"Status"}},{"name":"exact","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Exact"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MedicineListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/medicines/{medicine_id}":{"get":{"summary":"Get Medicine Detail","operationId":"medicine_detail","parameters":[{"name":"medicine_id","in":"path","required":true,"schema":{"type":"integer","title":"Medicine Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/medicines/{medicine_id}/diagnoses":{"get":{"summary":"Get Medicine Diagnoses","description":"The diagnoses this medicine's own indication section names.\n\nThe disease links read backwards. Nothing here is asserted: each row is a\ncode whose name appears in section 4.1 of this product's KÜB, with the\nsentence it appears in.","operationId":"medicine_diagnoses","parameters":[{"name":"medicine_id","in":"path","required":true,"schema":{"type":"integer","title":"Medicine Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/medicines/{medicine_id}/leaflet":{"get":{"summary":"Api Patient Leaflet","description":"The KT (patient leaflet) sections for a medicine, in document order.\n\nThe manufacturer's own plain-Turkish text as approved by TİTCK: what the\nmedicine is for, what to watch out for, how to take it, what side effects\nto expect. Quoted, never rewritten -- a paraphrase of a leaflet is not the\nleaflet, and the reason to show this to a patient is that it is the\nofficial document rather than a summary of one.","operationId":"patient_leaflet","parameters":[{"name":"medicine_id","in":"path","required":true,"schema":{"type":"integer","title":"Medicine Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/system/leaflet-coverage":{"get":{"summary":"Api Leaflet Coverage","description":"How much of the corpus has a readable patient leaflet behind it.","operationId":"leaflet_coverage","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/medicines/{medicine_id}/document-sections":{"get":{"summary":"Get Document Sections","operationId":"document_sections","parameters":[{"name":"medicine_id","in":"path","required":true,"schema":{"type":"integer","title":"Medicine Id"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","pattern":"^(kub|kt)$","default":"kub","title":"Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/stats":{"get":{"summary":"Get Stats","operationId":"stats","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatsResponse"}}}}}}},"/api/export":{"get":{"summary":"Export All","description":"Bulk corpus export. Requires an operator-issued key; closed by default.","operationId":"export_all","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(json|csv)$","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ExportApiKey":[]}]}},"/api/clinical/query":{"post":{"summary":"Api Clinical Query","description":"Executes full NLU parsing, hybrid candidate retrieval, deterministic rule evaluation, and explanation.","operationId":"clinical_query","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClinicalQueryApiRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClinicalEngineResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/clinical/check":{"post":{"summary":"Api Clinical Check","description":"Evaluates safety rules on a specific medicine against a patient profile.","operationId":"clinical_check","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClinicalCheckApiRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/voice/transcribe":{"post":{"summary":"Api Voice Transcribe","description":"Transcribes medical voice audio using local Whisper model with medical phonetic post-processing.","operationId":"voice_transcribe","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/clinical/audit":{"post":{"summary":"Api Clinical Audit","description":"Audits a prescription for interactions, duplication and curated QT risk.\n\nNot cumulative anticholinergic or bleeding burden: there is no ACB or ADS\ntable here. The claim used to sit in this line, which reaches an agent\nthrough the OpenAPI schema exactly as the MCP description does.\n\nNot dose appropriateness for renal or hepatic function either. A drug\ncontraindicated at this patient's clearance is not a pair, so it is\nabsent from every array here -- and `summary` speaks in the prescription's\nname (\"Reçetede 2 ilaç çifti ...\"), which a reader takes for a verdict on\nthe prescription. Metformin at a CrCl of 21 is the clearest stop in an\neight-drug list and this endpoint cannot see it; `/api/calculators/renal`\nis where that question is answered.","operationId":"clinical_audit","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrescriptionAuditRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"Api Clinical Audit Get","description":"GET endpoint to audit a comma-separated list of medications or a free clinical query.","operationId":"clinical_audit_get","parameters":[{"name":"meds","in":"query","required":false,"schema":{"type":"string","default":"","title":"Meds"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrescriptionAuditResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/search":{"get":{"summary":"Api Agent Search","description":"Universal medicine, active-ingredient and indication search. Alias of /api/clinical/search.","operationId":"search_medicines","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","description":"Drug name, active ingredient or condition","default":"","title":"Q"},"description":"Drug name, active ingredient or condition"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClinicalSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/interactions/analyze":{"get":{"summary":"Api Agent Interactions","description":"Drug-drug interaction, duplication and cumulative-risk analysis.\n\nPairs only: no cumulative anticholinergic or bleeding burden, and no dose\ncheck against renal or hepatic function -- a renally contraindicated drug\nappears in no array here. See /api/calculators/renal.\n\nAlias of GET /api/clinical/audit, minus the fields that only repeat\nothers: findings arrive once in `interactions` with their own `severity`,\nand the tallies are in `counts`. See `_compact_audit`.","operationId":"analyze_drug_interactions","parameters":[{"name":"drugs","in":"query","required":false,"schema":{"type":"string","description":"Comma-separated list of two or more medicine names","default":"","title":"Drugs"},"description":"Comma-separated list of two or more medicine names"},{"name":"q","in":"query","required":false,"schema":{"type":"string","description":"Free-text clinical query to extract medications from","default":"","title":"Q"},"description":"Free-text clinical query to extract medications from"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrescriptionAuditResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/calculators/renal":{"get":{"summary":"Api Agent Renal","description":"Query-parameter renal assessment for agents.\n\nEither pass a known `crcl`, or pass age/weight_kg/serum_creatinine to have\nCockcroft-Gault compute it. When `drug` is given and a curated titration\nrule covers it, the rule is returned with its KÜB section and quote; when no\nrule covers it the response says so rather than inventing a dose.","operationId":"calculate_renal_function","parameters":[{"name":"crcl","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Known creatinine clearance in mL/min","title":"Crcl"},"description":"Known creatinine clearance in mL/min"},{"name":"drug","in":"query","required":false,"schema":{"type":"string","description":"Medicine or active ingredient to check for a renal titration rule","default":"","title":"Drug"},"description":"Medicine or active ingredient to check for a renal titration rule"},{"name":"age","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Patient age in years; required when crcl is not given","title":"Age"},"description":"Patient age in years; required when crcl is not given"},{"name":"weight_kg","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Patient weight in kg; required when crcl is not given","title":"Weight Kg"},"description":"Patient weight in kg; required when crcl is not given"},{"name":"serum_creatinine","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Serum creatinine in mg/dL; required when crcl is not given","title":"Serum Creatinine"},"description":"Serum creatinine in mg/dL; required when crcl is not given"},{"name":"sex","in":"query","required":false,"schema":{"type":"string","description":"male or female","default":"male","title":"Sex"},"description":"male or female"},{"name":"weight_basis","in":"query","required":false,"schema":{"type":"string","description":"Which weight `weight_kg` is: actual, ideal or adjusted body weight. Declared, not computed -- nothing is converted; actual weight overestimates clearance in obesity and the answer repeats the basis back.","default":"actual","title":"Weight Basis"},"description":"Which weight `weight_kg` is: actual, ideal or adjusted body weight. Declared, not computed -- nothing is converted; actual weight overestimates clearance in obesity and the answer repeats the basis back."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenalAssessmentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Api Calc Renal","description":"Calculates CrCl and eGFR using Cockcroft-Gault, CKD-EPI and MDRD formulas.","operationId":"calculate_renal_function_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenalCalcRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/calculators/child-pugh":{"post":{"summary":"Api Calc Child Pugh","description":"Calculates the Child-Pugh hepatic score, class and dosage implications.","operationId":"calculate_child_pugh","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChildPughCalcRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/calculators/meld":{"post":{"summary":"Api Calc Meld","operationId":"calc_meld","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeldCalcRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/calculators/body-metrics":{"post":{"summary":"Api Calc Body Metrics","operationId":"calc_body_metrics","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyMetricsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/calculators/steroid":{"post":{"summary":"Api Calc Steroid","operationId":"calc_steroid","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SteroidCalcRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/calculators/qtc":{"post":{"summary":"Api Calc Qtc","operationId":"calc_qtc","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QtcCalcRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/calculators/cha2ds2-vasc":{"post":{"summary":"Api Calc Cha2Ds2 Vasc","operationId":"calc_cha2ds2_vasc","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Cha2ds2VascCalcRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/calculators/has-bled":{"post":{"summary":"Api Calc Has Bled","operationId":"calc_has_bled","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HasBledCalcRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/calculators/pediatric":{"post":{"summary":"Api Calc Pediatric","operationId":"calc_pediatric","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PediatricCalcRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/calculators/lactation/{ingredient_name}":{"get":{"summary":"Api Calc Lactation","operationId":"calc_lactation","parameters":[{"name":"ingredient_name","in":"path","required":true,"schema":{"type":"string","title":"Ingredient Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/account/register":{"post":{"summary":"Api Account Register","description":"Create an account on the free plan and return its key, once.\n\nThe key is shown here and never again: only its SHA-256 is stored, so\nthis response is the only copy that will ever exist. Losing it means\nissuing another, which is the correct trade -- a database that could\nprint a customer's key is a database whose nightly backup can too.\n\nIssuing another is what this endpoint does for a free account whose owner\ntyped the same address again: the old keys are revoked and one new key is\nreturned. Replacing without revoking would be the worse half of both\nworlds -- the owner holds a new credential and whoever found the old one\nstill holds a working credential.\n\nIt refuses to do that for a paid account, which is a hole this endpoint\nhad. `create_api_account` is INSERT OR IGNORE plus SELECT, so it returned\nwhatever account already held the address; typing a paying customer's\ne-mail here minted a key on *their* subscription. A paid key is recovered\nthrough the claim path instead, where the receipt number is the proof.\nSaying so tells a stranger that an address has a subscription, which is a\nsmall leak knowingly taken over handing them the subscription.\n\nTwo things stand in front of it. A Cloudflare Turnstile challenge, which\na browser passes and a script looping over a proxy list does not, and the\nhourly cap per address underneath it. The cap alone was the wrong shape\nfor the threat -- an address is not a person, and a proxy pool gets three\nan hour *each* -- but it is the right second line, so both apply.\n\nWhen Turnstile is not configured the challenge is skipped rather than\nfaked: `configured()` is false, this route does not pretend a check ran,\nand /api/system/status publishes that the guard is off.\n\nThere is no email verification yet. That is a real gap: an unverified\naddress can still take a free plan. Until there is, the free recovery\npath is only as strong as knowing the address -- worth 200 requests a\nday, and the owner takes it back the same way.","operationId":"account_register","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/account/claim":{"post":{"summary":"Api Account Claim","description":"The key for an account that was opened by arrangement.\n\nProved with two things the customer has and a stranger does not: the\naddress the plan is registered to, and the reference issued with it.\nEither alone would be enough for someone else -- an address is public and\na reference on its own is a small string.\n\nIssued as many times as it is proved. A second call used to be refused\nwith \"contact support\", which was a dead end wearing a helpful tone:\nthere is no support desk behind that sentence, and the customer who lost\nthe key had paid for the plan. The proof is unchanged between the first\ncall and the second, so the answer is too -- the previous key is revoked\nand a new one is returned. What the reference buys is the account, not\none draw from it.","operationId":"account_claim","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/account/usage":{"get":{"summary":"Api Account Usage","description":"This key's plan and what it has spent.","operationId":"account_usage","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/account/plans":{"get":{"summary":"Api Account Plans","description":"The tiers and their ceilings, and how each one is opened.\n\nNo price and no checkout link. The payment provider was removed, and a\nplans endpoint that still advertised a purchase route would be describing\na door that is not there. What it does say is what the limiter enforces\nand where a caller who wants more asks for it.","operationId":"account_plans","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/feedback":{"post":{"summary":"Api Submit Feedback","description":"Submits user feedback, data corrections, and bug reports directly to Slack with honeypot bot defense.","operationId":"submit_feedback","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/sut/exemption":{"get":{"summary":"Api Sut Exemption","description":"Whether a diagnosis appears on SGK's EK-4/D co-payment exemption list.\n\n`published_on` is not decoration. The list SGK serves is the one it\npublished on 18 October 2017 -- SUT 4.1.6/(5) names that page as the\nofficial location and nothing newer sits there. A drug added since is\nmissing here; one removed still appears, and that direction misleads. This\nreports what the published list says, never a patient's entitlement, which\nonly Medula answers.","operationId":"copayment_exemption","parameters":[{"name":"icd10","in":"query","required":false,"schema":{"type":"string","description":"ICD-10 code, e.g. 'I50' or 'I50.0'","default":"","title":"Icd10"},"description":"ICD-10 code, e.g. 'I50' or 'I50.0'"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/sut/general-rules":{"get":{"summary":"Api Sut General Rules","description":"Section 4.1 of the tebliğ: prescription and report rules, verbatim.","operationId":"sut_general_rules","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/mechanisms":{"get":{"summary":"Api Mechanism Targets","description":"Which enzymes and transporters the corpus's documents name, and how often.\n\nThe index behind /yolaklar. It reports how many molecules mention a\npathway -- not how many are substrates of it, which is a claim this\nservice does not make in any surface.","operationId":"metabolic_pathways","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/mechanisms/{target}":{"get":{"summary":"Api Mechanism Molecules","description":"Molecules whose own KÜB names this enzyme or transporter, with the quote.","operationId":"molecules_naming_pathway","parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","title":"Target"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/tools":{"get":{"summary":"Get Webmcp Tools","description":"Serves WebMCP tool registry definition for agentic browsers and assistive agents.","operationId":"webmcp_tools","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/sut/rules":{"get":{"summary":"Api Get Sut Rules","description":"SUT reimbursement standing and prescribing conditions.\n\nPass `barcode` to get the official answer. SGK publishes EK-4/A keyed on\nbarcode, so without one this can only report the curated conditions -- and\nthose cover seven molecules.","operationId":"get_sut_rules","parameters":[{"name":"ingredient","in":"query","required":false,"schema":{"type":"string","default":"","title":"Ingredient"}},{"name":"atc","in":"query","required":false,"schema":{"type":"string","default":"","title":"Atc"}},{"name":"product","in":"query","required":false,"schema":{"type":"string","default":"","title":"Product"}},{"name":"barcode","in":"query","required":false,"schema":{"type":"string","description":"GTIN-13; the key SGK's EK-4/A is published on","default":"","title":"Barcode"},"description":"GTIN-13; the key SGK's EK-4/A is published on"},{"name":"specialty","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Specialty"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SUTComplianceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/sut/articles":{"get":{"summary":"Api Sut Articles","description":"The tebliğ's own articles covering a molecule, quoted.\n\nNot a structured rule. \"Sağlık raporuna istinaden iç hastalıkları veya\nçocuk hastalıkları uzman hekimlerince reçete edilebilen\" does not reduce to\na boolean without losing what a pharmacist needs from it, so the article is\nreturned whole with its number and amendment date and the reader decides.","operationId":"sut_articles","parameters":[{"name":"ingredient","in":"query","required":false,"schema":{"type":"string","description":"Active ingredient name","default":"","title":"Ingredient"},"description":"Active ingredient name"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":1,"default":3,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/medicines/{medicine_id}/sut":{"get":{"summary":"Api Get Medicine Sut","description":"Fetches full SUT rules and bioequivalent market alternatives for a medicine.","operationId":"get_medicine_sut","parameters":[{"name":"medicine_id","in":"path","required":true,"schema":{"type":"integer","title":"Medicine Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/bulletin/recalls":{"get":{"summary":"Api Get Bulletin Recalls","description":"Returns official TİTCK drug safety alerts and batch recalls.","operationId":"get_bulletin_recalls","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/medicines/{medicine_id}/alerts":{"get":{"summary":"Api Get Medicine Alerts","description":"Checks if a medicine has active TİTCK recalls or safety alerts.","operationId":"get_medicine_alerts","parameters":[{"name":"medicine_id","in":"path","required":true,"schema":{"type":"integer","title":"Medicine Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/system/status":{"get":{"summary":"Api System Status","description":"System health, offline mode, model version, and corpus freshness.","operationId":"system_status","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemStatusResponse"}}}}}}},"/api/system/freshness":{"get":{"summary":"Api Corpus Freshness","description":"How old this corpus is, per source, and how much of it the register confirms.\n\nAn agent quoting a price or a licence status should be able to say when it\nwas last verified. Everything here is measured from the data itself.","operationId":"corpus_freshness","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/system/changes":{"get":{"summary":"Api Recent Changes","description":"What moved in the corpus over the last `days`, counted from the newest record.","operationId":"recent_changes","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":7,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"BodyMetricsRequest":{"properties":{"height_cm":{"type":"number","title":"Height Cm"},"weight_kg":{"type":"number","title":"Weight Kg"},"sex":{"type":"string","title":"Sex","default":"male"}},"type":"object","required":["height_cm","weight_kg"],"title":"BodyMetricsRequest"},"CandidateDrug":{"properties":{"ingredient_name":{"type":"string","title":"Ingredient Name"},"atc_code":{"type":"string","title":"Atc Code"},"atc_classification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Atc Classification"},"clinical_group_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Clinical Group Slug"},"clinical_group_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Clinical Group Name"},"indications":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Indications"},"contraindications":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contraindications"},"side_effects":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Side Effects"},"interactions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Interactions"},"posology_dosage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Posology Dosage"},"max_daily_dose":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Max Daily Dose"},"pregnancy_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pregnancy Category"},"pregnancy_info":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pregnancy Info"},"lactation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lactation Status"},"renal_dose_info":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Renal Dose Info"},"hepatic_dose_info":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hepatic Dose Info"},"overall_decision":{"$ref":"#/components/schemas/SafetyDecision","default":"approved"},"rule_results":{"items":{"$ref":"#/components/schemas/RuleEvaluationResult"},"type":"array","title":"Rule Results"},"relevance_score":{"type":"number","title":"Relevance Score","default":0.0},"icd10_evidence":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Icd10 Evidence"},"products":{"items":{"$ref":"#/components/schemas/VerifiedProduct"},"type":"array","title":"Products"}},"type":"object","required":["ingredient_name","atc_code"],"title":"CandidateDrug","description":"Evaluated clinical candidate grouping commercial preparations by active ingredient / molecule."},"Cha2ds2VascCalcRequest":{"properties":{"age":{"type":"integer","title":"Age"},"sex":{"type":"string","title":"Sex","default":"male"},"congestive_heart_failure":{"type":"boolean","title":"Congestive Heart Failure","default":false},"hypertension":{"type":"boolean","title":"Hypertension","default":false},"diabetes":{"type":"boolean","title":"Diabetes","default":false},"stroke_tia_thromboembolism":{"type":"boolean","title":"Stroke Tia Thromboembolism","default":false},"vascular_disease":{"type":"boolean","title":"Vascular Disease","default":false}},"type":"object","required":["age"],"title":"Cha2ds2VascCalcRequest"},"ChildPughCalcRequest":{"properties":{"total_bilirubin":{"type":"number","title":"Total Bilirubin"},"serum_albumin":{"type":"number","title":"Serum Albumin"},"inr":{"type":"number","title":"Inr"},"ascites":{"type":"string","title":"Ascites","default":"none"},"encephalopathy":{"type":"string","title":"Encephalopathy","default":"none"}},"type":"object","required":["total_bilirubin","serum_albumin","inr"],"title":"ChildPughCalcRequest"},"ClaimRequest":{"properties":{"email":{"type":"string","title":"Email","description":"Planın tanımlı olduğu e-posta adresi"},"reference":{"type":"string","title":"Reference","description":"Plan tanımlanırken verilen referans numarası"}},"type":"object","required":["email","reference"],"title":"ClaimRequest"},"ClassFallback":{"properties":{"term":{"type":"string","title":"Term"},"class":{"type":"string","title":"Class","description":"The class that answered","default":""},"note":{"type":"string","title":"Note","description":"The sentence a reader is owed","default":""}},"additionalProperties":true,"type":"object","required":["term"],"title":"ClassFallback","description":"Set when the phrase matched no product and no ingredient, and the list\nis the class's members instead.\n\n`class_match` does not say this: \"amlodipin\" names a class *and* a\nhundred products, and carries the same field. Without this one, a search\nfor \"valproat\" and a search for \"antiepileptik\" returned the same rows\nand were distinguishable only by the query echoed back."},"ClassMatch":{"properties":{"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name","default":""}},"additionalProperties":true,"type":"object","required":["slug"],"title":"ClassMatch","description":"The drug class a typed phrase resolved to, when it named one."},"ClinicalCheckApiRequest":{"properties":{"medicine_id":{"type":"integer","title":"Medicine Id"},"profile":{"$ref":"#/components/schemas/ClinicalQuery"}},"type":"object","required":["medicine_id","profile"],"title":"ClinicalCheckApiRequest"},"ClinicalEngineResponse":{"properties":{"query_id":{"type":"string","title":"Query Id"},"raw_query":{"type":"string","title":"Raw Query"},"parsed_query":{"$ref":"#/components/schemas/ClinicalQuery"},"approved_candidates":{"items":{"$ref":"#/components/schemas/CandidateDrug"},"type":"array","title":"Approved Candidates"},"caution_candidates":{"items":{"$ref":"#/components/schemas/CandidateDrug"},"type":"array","title":"Caution Candidates"},"excluded_candidates":{"items":{"$ref":"#/components/schemas/CandidateDrug"},"type":"array","title":"Excluded Candidates"},"total_candidates_retrieved":{"type":"integer","title":"Total Candidates Retrieved","default":0},"candidates_considered":{"type":"integer","title":"Candidates Considered","default":0},"truncation_note":{"type":"string","title":"Truncation Note","default":""},"total_approved":{"type":"integer","title":"Total Approved","default":0},"total_excluded":{"type":"integer","title":"Total Excluded","default":0},"explanation_markdown":{"type":"string","title":"Explanation Markdown","default":""},"clinical_disclaimer":{"type":"string","title":"Clinical Disclaimer","default":"Bu klinik karar destek çıktısı yalnızca yetkili hekim ve eczacıların değerlendirmesine yönelik bilgilendirme amaçlıdır. Nihai klinik karar ve reçete sorumluluğu hekime aittir. Bağlayıcı resmi bilgi için TİTCK tarafından onaylanmış güncel KÜB / KT belgelerini esas alınız."},"execution_time_ms":{"type":"number","title":"Execution Time Ms","default":0.0},"model_version":{"type":"string","title":"Model Version","default":"ilacatlas-clinical-v1.0"},"database_version":{"type":"string","title":"Database Version","default":"sqlite-medicines-11.2k"},"rules_version":{"type":"string","title":"Rules Version","default":"v1.0-deterministic"}},"type":"object","required":["query_id","raw_query","parsed_query"],"title":"ClinicalEngineResponse","description":"Final unified response from the Clinical Intelligence Engine."},"ClinicalIntent":{"type":"string","enum":["drug_search","safety_check","equivalent_search","indication_search","interaction_check","unknown"],"title":"ClinicalIntent"},"ClinicalQuery":{"properties":{"raw_query":{"type":"string","title":"Raw Query","description":"Original user prompt","default":""},"intent":{"$ref":"#/components/schemas/ClinicalIntent","description":"Primary clinical intent","default":"drug_search"},"symptoms":{"items":{"type":"string"},"type":"array","title":"Symptoms","description":"Extracted symptom terms"},"diagnoses":{"items":{"type":"string"},"type":"array","title":"Diagnoses","description":"Extracted diagnosis / ICD-10 concepts"},"age":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Age","description":"Patient age in years"},"age_months":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Age Months","description":"Patient age in months if pediatric"},"weight_kg":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Weight Kg","description":"Patient weight in kg"},"sex":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sex","description":"Patient sex: 'male', 'female'"},"pregnancy":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Pregnancy","description":"True if pregnant"},"pregnancy_trimester":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Pregnancy Trimester","description":"1, 2, or 3 if specified"},"lactation":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Lactation","description":"True if breastfeeding/lactating"},"egfr":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Egfr","description":"eGFR value in mL/min/1.73m2"},"crcl":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Crcl","description":"Creatinine clearance in mL/min"},"renal_impairment":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Renal Impairment","description":"True if renal impairment stated"},"hepatic_impairment":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hepatic Impairment","description":"True if hepatic impairment stated"},"allergies":{"items":{"type":"string"},"type":"array","title":"Allergies","description":"Reported drug or substance allergies"},"current_medications":{"items":{"type":"string"},"type":"array","title":"Current Medications","description":"Patient's current active medications"},"requested_drug_classes":{"items":{"type":"string"},"type":"array","title":"Requested Drug Classes","description":"ATC drug classes or group names"},"requested_active_ingredients":{"items":{"type":"string"},"type":"array","title":"Requested Active Ingredients","description":"Requested active molecules"},"requested_brand_names":{"items":{"type":"string"},"type":"array","title":"Requested Brand Names","description":"Specific trade names mentioned"},"route":{"items":{"type":"string"},"type":"array","title":"Route","description":"e.g. 'oral', 'intravenous', 'topical'"},"dosage_forms":{"items":{"type":"string"},"type":"array","title":"Dosage Forms","description":"e.g. 'tablet', 'şurup', 'damla'"},"avoid":{"items":{"type":"string"},"type":"array","title":"Avoid","description":"Classes or attributes to avoid (e.g. 'sedatif', 'nsaii')"},"preferences":{"items":{"type":"string"},"type":"array","title":"Preferences","description":"Preferences (e.g. 'renal_safety', 'once_daily')"}},"type":"object","title":"ClinicalQuery","description":"Structured clinical intent and parameters parsed from Turkish natural language."},"ClinicalQueryApiRequest":{"properties":{"query":{"type":"string","title":"Query","default":""},"profile":{"anyOf":[{"$ref":"#/components/schemas/ClinicalQuery"},{"type":"null"}]},"max_candidates":{"type":"integer","title":"Max Candidates","default":40}},"type":"object","title":"ClinicalQueryApiRequest"},"ClinicalSearchResponse":{"properties":{"query":{"type":"string","title":"Query"},"total_results":{"type":"integer","title":"Total Results"},"medicines":{"items":{"$ref":"#/components/schemas/MedicineSummary"},"type":"array","title":"Medicines"},"active_ingredient_groups":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Active Ingredient Groups","description":"Ingredient hubs matching the query"},"class_match":{"anyOf":[{"$ref":"#/components/schemas/ClassMatch"},{"type":"null"}]},"class_fallback":{"anyOf":[{"$ref":"#/components/schemas/ClassFallback"},{"type":"null"}],"description":"Set when nothing matched the phrase itself and the results are a class's members"},"fragment_match":{"anyOf":[{"$ref":"#/components/schemas/ClassFallback"},{"type":"null"}],"description":"Set when the phrase appears only inside longer words in the rows below -- “ağrı” in AGRİLOR -- and matched no name or ingredient as a whole word"},"company_match":{"anyOf":[{"$ref":"#/components/schemas/CompanyMatch"},{"type":"null"}],"description":"Set when the phrase named no product and no ingredient but did name a licence holder; the rows below are that company’s catalogue"},"class_suggestions":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Class Suggestions","description":"Classes the phrase resembles without naming; a suggestion, never applied"}},"additionalProperties":true,"type":"object","required":["query","total_results","medicines"],"title":"ClinicalSearchResponse"},"CompanyMatch":{"properties":{"term":{"type":"string","title":"Term","description":"The phrase that matched a company","default":""},"companies":{"items":{"type":"string"},"type":"array","title":"Companies","description":"The register spellings that matched, in full"},"note":{"type":"string","title":"Note","description":"The sentence a reader is owed","default":""}},"additionalProperties":true,"type":"object","title":"CompanyMatch","description":"The licence holder answered, and the page has to say so.\n\nA company's catalogue and a molecule's preparations look the same in a\nresult table; only this note tells them apart."},"DiagnosisEvidence":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug","default":""},"active_ingredient":{"type":"string","title":"Active Ingredient","default":""},"atc_code":{"type":"string","title":"Atc Code","default":""},"evidence":{"type":"string","title":"Evidence","description":"The indication sentence that matched. This is the answer, not a summary of it.","default":""},"matched_term":{"type":"string","title":"Matched Term","description":"The diagnosis term found in that sentence","default":""},"agreement":{"type":"string","title":"Agreement","description":"ATC cross-check verdict: uyumlu, beklenmedik or belirsiz","default":""},"evidence_polarity":{"type":"string","title":"Evidence Polarity","description":"What the matched sentence says about this diagnosis. 'positive': it names the diagnosis and nothing read here refuses the use. 'negative': it names it in order to warn against the drug. 'risk_factor': it names it as a property of the patient rather than the thing treated -- an anticoagulant's atrial-fibrillation indication lists hypertension, diabetes and heart failure as risk factors. 'not_treated': it names the diagnosis as an effect the drug causes, an operation the patient had, or one item in the population described -- olanzapine reaching hyperlipidaemia through \"kilo artışı ve hiperlipidemi için artan potansiyeli\". The last three sort to the bottom; none is dropped.","default":"positive"}},"additionalProperties":true,"type":"object","required":["id","name"],"title":"DiagnosisEvidence","description":"A medicine whose own KÜB 4.1 names the diagnosis, with the sentence."},"DiagnosisMedicinesResponse":{"properties":{"total":{"type":"integer","title":"Total"},"medicines":{"items":{"$ref":"#/components/schemas/DiagnosisEvidence"},"type":"array","title":"Medicines"},"agreement":{"additionalProperties":{"type":"integer"},"type":"object","title":"Agreement","description":"Counts per verdict across the whole result, not just this page"},"agreement_note":{"type":"string","title":"Agreement Note","description":"What `agreement` counts, and what it does not: it compares the product's ATC code with the diagnosis's ICD chapter, not the term's relevance to the diagnosis","default":""},"negative_evidence":{"type":"integer","title":"Negative Evidence","description":"Rows whose sentence warns against the use, counted over the whole code rather than this page","default":0},"risk_factor_evidence":{"type":"integer","title":"Risk Factor Evidence","description":"Rows whose sentence names the diagnosis as a property of the patient, counted the same way","default":0},"not_treated_evidence":{"type":"integer","title":"Not Treated Evidence","description":"Rows whose sentence names the diagnosis as something the drug does not treat: an effect it causes, an operation the patient had, or one item in the population described","default":0},"polarity_note":{"type":"string","title":"Polarity Note","description":"What the three values of `evidence_polarity` mean","default":""}},"additionalProperties":true,"type":"object","required":["total","medicines"],"title":"DiagnosisMedicinesResponse"},"FeedbackRequest":{"properties":{"category":{"type":"string","title":"Category","default":"general"},"message":{"type":"string","title":"Message"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Url"},"medicine_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medicine Name"},"medicine_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Medicine Id"},"honeypot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Honeypot"},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website Url"}},"type":"object","required":["message"],"title":"FeedbackRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HasBledCalcRequest":{"properties":{"hypertension_uncontrolled":{"type":"boolean","title":"Hypertension Uncontrolled","default":false},"abnormal_renal_function":{"type":"boolean","title":"Abnormal Renal Function","default":false},"abnormal_liver_function":{"type":"boolean","title":"Abnormal Liver Function","default":false},"stroke_history":{"type":"boolean","title":"Stroke History","default":false},"bleeding_history":{"type":"boolean","title":"Bleeding History","default":false},"labile_inr":{"type":"boolean","title":"Labile Inr","default":false},"elderly_over_65":{"type":"boolean","title":"Elderly Over 65","default":false},"drugs_antiplatelet_nsaid":{"type":"boolean","title":"Drugs Antiplatelet Nsaid","default":false},"alcohol_excess":{"type":"boolean","title":"Alcohol Excess","default":false}},"type":"object","title":"HasBledCalcRequest"},"InteractionFinding":{"properties":{"drug_1":{"type":"string","title":"Drug 1"},"drug_2":{"type":"string","title":"Drug 2"},"severity":{"type":"string","title":"Severity","description":"critical, major, moderate or minor; the same value clinical_significance and counts are derived from","default":""},"decision":{"type":"string","title":"Decision","description":"excluded, caution, approved or insufficient_data","default":""},"title":{"type":"string","title":"Title","default":""},"reason":{"type":"string","title":"Reason","default":""},"mechanism":{"type":"string","title":"Mechanism","description":"Pharmacological mechanism where stated","default":""},"clinical_significance":{"type":"string","title":"Clinical Significance","default":""},"clinical_advice":{"type":"string","title":"Clinical Advice","description":"What to do about it","default":""},"monitoring":{"type":"string","title":"Monitoring","description":"Parameter to follow, e.g. INR, K+, QTc","default":""},"documents":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Documents","description":"Sentences from the products' own KÜB 4.5, quoted verbatim"},"evidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence","description":"Verbatim quote from the source document. None when the finding comes from a curated rule and no document was read -- `source` then names the rule rather than TİTCK"},"source":{"type":"string","title":"Source","default":""},"source_section":{"type":"string","title":"Source Section","description":"KÜB section, e.g. 'KÜB 4.5'","default":""}},"additionalProperties":true,"type":"object","required":["drug_1","drug_2"],"title":"InteractionFinding","description":"One drug-drug interaction, traceable to the section it came from."},"MedicineListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/MedicineSummary"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"class_match":{"anyOf":[{"$ref":"#/components/schemas/ClassMatch"},{"type":"null"}],"description":"Set when the query named a drug class and the class was folded in"}},"additionalProperties":true,"type":"object","required":["items","total","limit","offset"],"title":"MedicineListResponse"},"MedicineSummary":{"properties":{"id":{"type":"integer","title":"Id","description":"İlaçAtlas primary key, stable"},"name":{"type":"string","title":"Name","description":"Product name as printed on the box"},"slug":{"type":"string","title":"Slug","description":"URL segment; /ilac/{slug} resolves"},"active_ingredient":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Active Ingredient","description":"Normalised active ingredient"},"atc_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Atc Code","description":"ATC as crawled from the source page"},"atc_effective":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Atc Effective","description":"TİTCK's ATC when the barcode matched the register, else atc_code. Prefer this."},"titck_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Titck Status","description":"'aktif' or 'pasif' in the TİTCK register; null means the barcode did not match and status is unverified"},"dosage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dosage","description":"Strength as printed, free text"},"form":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Form","description":"Pharmaceutical form; frequently absent at source"},"retail_price":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Retail Price","description":"Price as a string including the currency symbol, e.g. '2303.72 ₺'. Not a number."},"manufacturer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Manufacturer","description":"Marketing authorisation holder; frequently absent"},"barcode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Barcode","description":"GTIN-13"},"prescription_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prescription Status","description":"Prescription class, free text"},"pregnancy_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pregnancy Category","description":"A/B/C/D/X where the KÜB states one"}},"additionalProperties":true,"type":"object","required":["id","name","slug"],"title":"MedicineSummary","description":"One product as it appears in a list.\n\nAlmost every descriptive field is Optional, and that is not defensiveness:\nthe columns are nullable and the crawl leaves them null when the source\npage does not state them. A null here means \"the source does not say\", not\n\"empty\" and never \"none\" -- an agent must not read a missing form or a\nmissing prescription status as an absence of restriction."},"MeldCalcRequest":{"properties":{"total_bilirubin":{"type":"number","title":"Total Bilirubin"},"inr":{"type":"number","title":"Inr"},"serum_creatinine":{"type":"number","title":"Serum Creatinine"},"serum_sodium":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Serum Sodium"},"on_dialysis":{"type":"boolean","title":"On Dialysis","default":false}},"type":"object","required":["total_bilirubin","inr","serum_creatinine"],"title":"MeldCalcRequest"},"PediatricCalcRequest":{"properties":{"drug_key":{"type":"string","title":"Drug Key"},"weight_kg":{"type":"number","title":"Weight Kg"}},"type":"object","required":["drug_key","weight_kg"],"title":"PediatricCalcRequest"},"PrescriptionAuditRequest":{"properties":{"medications":{"items":{"type":"string"},"type":"array","title":"Medications","default":[]},"query":{"type":"string","title":"Query","default":""}},"type":"object","title":"PrescriptionAuditRequest"},"PrescriptionAuditResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"overall_status":{"type":"string","title":"Overall Status","description":"Worst finding across the prescription","default":""},"scope_note":{"type":"string","title":"Scope Note","description":"What this audit did not examine. It sees drug pairs: dose appropriateness for renal or hepatic function is not checked, so a drug contraindicated at the patient's clearance appears in none of these arrays","default":""},"total_medications":{"type":"integer","title":"Total Medications","default":0},"medications":{"items":{"type":"string"},"type":"array","title":"Medications","description":"Medicines as resolved from the request"},"interactions":{"items":{"$ref":"#/components/schemas/InteractionFinding"},"type":"array","title":"Interactions"},"major_interactions":{"items":{"$ref":"#/components/schemas/InteractionFinding"},"type":"array","title":"Major Interactions"},"moderate_interactions":{"items":{"$ref":"#/components/schemas/InteractionFinding"},"type":"array","title":"Moderate Interactions"},"ungraded_interactions":{"items":{"$ref":"#/components/schemas/InteractionFinding"},"type":"array","title":"Ungraded Interactions","description":"Findings from a document mention with no curated rule: the sentence is quoted and the severity is not decided"},"critical_interactions":{"items":{"$ref":"#/components/schemas/InteractionFinding"},"type":"array","title":"Critical Interactions","description":"Severity 'critical' only; `major_interactions` holds critical and major together, the ones needing action now"},"unmatched_pairs":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Unmatched Pairs"},"unresolved_drugs":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Unresolved Drugs","description":"Names the corpus does not recognise, with suggestions. A non-empty list means part of the prescription was not checked at all"},"duplications":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Duplications","description":"Therapeutic duplication findings"},"summary":{"type":"string","title":"Summary","default":""},"counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Counts"}},"additionalProperties":true,"type":"object","required":["success"],"title":"PrescriptionAuditResponse"},"QtcCalcRequest":{"properties":{"qt_interval_ms":{"type":"number","title":"Qt Interval Ms"},"heart_rate_bpm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Heart Rate Bpm"},"rr_interval_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rr Interval Ms"},"sex":{"type":"string","title":"Sex","default":"male"}},"type":"object","required":["qt_interval_ms"],"title":"QtcCalcRequest"},"QueueStats":{"properties":{"pending":{"type":"integer","title":"Pending"},"completed":{"type":"integer","title":"Completed"},"total":{"type":"integer","title":"Total"}},"additionalProperties":true,"type":"object","required":["pending","completed","total"],"title":"QueueStats"},"RegisterRequest":{"properties":{"email":{"type":"string","maxLength":254,"title":"Email"},"cf-turnstile-response":{"type":"string","maxLength":4096,"title":"Cf-Turnstile-Response","default":""}},"type":"object","required":["email"],"title":"RegisterRequest"},"RenalAssessmentResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"crcl_ml_min":{"type":"number","title":"Crcl Ml Min"},"crcl_source":{"type":"string","title":"Crcl Source","description":"'supplied' or 'cockcroft_gault'"},"stage":{"type":"string","title":"Stage","description":"KDIGO stage, e.g. 'Evre G4'"},"stage_description":{"type":"string","title":"Stage Description"},"badge_color":{"type":"string","title":"Badge Color"},"is_impaired":{"type":"boolean","title":"Is Impaired"},"is_severe":{"type":"boolean","title":"Is Severe"},"is_end_stage":{"type":"boolean","title":"Is End Stage"},"drug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Drug"},"dose_adjustment":{"anyOf":[{"$ref":"#/components/schemas/RenalDoseRule"},{"type":"null"}],"description":"Null when no curated rule covers the drug -- read dose_adjustment_note, do not infer a dose"},"dose_adjustment_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dose Adjustment Note"}},"additionalProperties":true,"type":"object","required":["crcl_ml_min","crcl_source","stage","stage_description","badge_color","is_impaired","is_severe","is_end_stage"],"title":"RenalAssessmentResponse"},"RenalCalcRequest":{"properties":{"age":{"type":"integer","title":"Age"},"weight_kg":{"type":"number","title":"Weight Kg","default":70.0},"serum_creatinine":{"type":"number","title":"Serum Creatinine"},"sex":{"type":"string","title":"Sex","default":"male"}},"type":"object","required":["age","serum_creatinine"],"title":"RenalCalcRequest"},"RenalDoseRule":{"properties":{"rule_id":{"type":"string","title":"Rule Id"},"decision":{"type":"string","title":"Decision"},"title":{"type":"string","title":"Title"},"reason":{"type":"string","title":"Reason"},"source_section":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Section","description":"KÜB 4.2 (posology) or 4.3 (contraindications)"},"evidence_quote":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Quote"},"severity":{"type":"string","title":"Severity","default":"info"}},"additionalProperties":true,"type":"object","required":["rule_id","decision","title","reason"],"title":"RenalDoseRule","description":"A curated titration rule, with the section it is quoted from."},"RuleEvaluationResult":{"properties":{"rule_id":{"type":"string","title":"Rule Id","description":"Unique rule identifier (e.g. RENAL_001, PREG_X_HARD)"},"decision":{"$ref":"#/components/schemas/SafetyDecision","description":"Evaluation verdict: approved, caution, excluded"},"title":{"type":"string","title":"Title","description":"Short title of the rule in Turkish"},"reason":{"type":"string","title":"Reason","description":"Clinical rationale for the decision in Turkish"},"source_section":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Section","description":"KÜB section reference (e.g. KÜB 4.3, KÜB 4.6)"},"evidence_quote":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Quote","description":"Verbatim text quote from official document"},"evidence_product":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Product","description":"Product whose document the quote was read from"},"from_document":{"type":"boolean","title":"From Document","description":"True when the finding comes from a KÜB section rather than a rule","default":false},"severity":{"type":"string","title":"Severity","description":"Severity level: critical, warning, info","default":"info"}},"type":"object","required":["rule_id","decision","title","reason"],"title":"RuleEvaluationResult","description":"Traceable decision record for a single clinical safety check."},"SUTComplianceResponse":{"properties":{"rule_coverage":{"type":"string","title":"Rule Coverage","description":"'covered' when a curated SUT rule matched, else 'not_covered'","default":"not_covered"},"has_sut_restriction":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Sut Restriction","description":"Null when no rule covers this product; not the same as False"},"reimbursement_status":{"type":"string","title":"Reimbursement Status"},"requires_report":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Requires Report","description":"Null when unknown; do not read as 'no report needed'"},"report_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Type"},"report_duration_months":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Report Duration Months"},"specialties_allowed":{"items":{"type":"string"},"type":"array","title":"Specialties Allowed","description":"Specialties that may initiate treatment"},"is_specialty_authorized":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Specialty Authorized"},"exemption_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exemption Code"},"summary":{"type":"string","title":"Summary","default":""},"clinical_note":{"type":"string","title":"Clinical Note","default":""}},"additionalProperties":true,"type":"object","required":["reimbursement_status"],"title":"SUTComplianceResponse","description":"Turkish SUT reimbursement conditions.\n\nAlmost every field is optional because the rule set is curated and small:\nwhen it does not cover a product, `rule_coverage` is \"not_covered\" and the\nrest is null. Null means unknown. It does not mean unrestricted, and it\ncertainly does not mean reimbursed -- reading it that way is how a\nprescription ends up unpaid."},"SafetyDecision":{"type":"string","enum":["approved","caution","excluded","insufficient_data","read_evidence"],"title":"SafetyDecision"},"StatsResponse":{"properties":{"total_medicines":{"type":"integer","title":"Total Medicines"},"total_active_ingredients":{"type":"integer","title":"Total Active Ingredients"},"total_manufacturers":{"type":"integer","title":"Total Manufacturers"},"total_atc_codes":{"type":"integer","title":"Total Atc Codes"},"last_scraped":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Scraped"},"top_forms":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Top Forms"},"queue":{"$ref":"#/components/schemas/QueueStats"}},"additionalProperties":true,"type":"object","required":["total_medicines","total_active_ingredients","total_manufacturers","total_atc_codes","queue"],"title":"StatsResponse"},"SteroidCalcRequest":{"properties":{"steroid_key":{"type":"string","title":"Steroid Key"},"dose_mg":{"type":"number","title":"Dose Mg"}},"type":"object","required":["steroid_key","dose_mg"],"title":"SteroidCalcRequest"},"SystemStatusResponse":{"properties":{"status":{"type":"string","title":"Status"},"offline_mode":{"type":"boolean","title":"Offline Mode"},"whisper_available":{"type":"boolean","title":"Whisper Available"},"local_llm_loaded":{"type":"boolean","title":"Local Llm Loaded"},"model_version":{"type":"string","title":"Model Version"},"database":{"additionalProperties":true,"type":"object","title":"Database"},"sales":{"additionalProperties":true,"type":"object","title":"Sales"},"signup_guard":{"additionalProperties":true,"type":"object","title":"Signup Guard"}},"additionalProperties":true,"type":"object","required":["status","offline_mode","whisper_available","local_llm_loaded","model_version","database","sales","signup_guard"],"title":"SystemStatusResponse"},"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"},"VerifiedProduct":{"properties":{"medicine_id":{"type":"integer","title":"Medicine Id"},"name":{"type":"string","title":"Name"},"active_ingredient":{"type":"string","title":"Active Ingredient"},"atc_code":{"type":"string","title":"Atc Code"},"form":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Form"},"dosage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dosage"},"packaging_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Packaging Size"},"barcode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Barcode"},"retail_price":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Retail Price"},"sgk_reimbursed_price":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sgk Reimbursed Price"},"manufacturer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Manufacturer"},"prescription_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prescription Status"},"kt_pdf_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kt Pdf Url"},"kub_pdf_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kub Pdf Url"},"has_local_pdf":{"type":"boolean","title":"Has Local Pdf","default":false}},"type":"object","required":["medicine_id","name","active_ingredient","atc_code"],"title":"VerifiedProduct","description":"Actual commercial medicine record verified from İlaçAtlas SQLite database."}},"securitySchemes":{"ExportApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Operator-issued key for licensed bulk export. Not required for any other endpoint."}}}}