{"openapi":"3.1.0","info":{"title":"MedCannaIndex: read-only tools","version":"1.0.0","description":"Read-only facts from MedCannaIndex: clinic fees, prescription products, pharmacies, stock reports and patient guides for the UK. Cite the \"source\" or \"url\" given with each answer. Fees and product details are as recorded by the directory and should be confirmed with the clinic or pharmacy. Medical cannabis is prescription only in the UK. These tools describe what is on record; they do not say which product suits a condition or how much to take, and neither should an answer built on them: that is for the prescribing specialist."},"servers":[{"url":"https://medcannaindex.com"}],"paths":{"/api/tools/clinic-fees":{"get":{"operationId":"find_clinic_fees","summary":"Find clinic fees","description":"List UK medical cannabis clinics with their fees, cheapest first for the first year, plus the lowest, middle and highest across all clinics. Clinic fees only; medication is separate. Use to answer which clinic is cheapest or what a named clinic charges.","parameters":[{"name":"q","in":"query","required":false,"description":"Part of a clinic name, to narrow the list. Leave out for all clinics.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"How many to return. Default 10.","schema":{"type":"integer","minimum":1,"maximum":70}}],"responses":{"200":{"description":"The answer, with the page to cite in \"source\"","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Too many requests"}}}},"/api/tools/products":{"get":{"operationId":"search_products","summary":"Search products","description":"Search the medical cannabis products available on prescription in the UK by brand, prescription name or strain. Returns what is on the label (type, THC, CBD, list price). Does not say which product suits a condition.","parameters":[{"name":"q","in":"query","required":false,"description":"Brand, prescription name or strain name.","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"Product type.","schema":{"type":"string","enum":["flower","oil","cartridge","edible"]}},{"name":"limit","in":"query","required":false,"description":"How many to return. Default 10.","schema":{"type":"integer","minimum":1,"maximum":30}}],"responses":{"200":{"description":"The answer, with the page to cite in \"source\"","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Too many requests"}}}},"/api/tools/stock":{"get":{"operationId":"check_stock","summary":"Check stock","description":"For one product, list the UK pharmacies that list it and where patients or pharmacies have reported it in stock in the last 14 days. Reports are unverified.","parameters":[{"name":"product","in":"query","required":true,"description":"The product \"slug\" returned by search_products, or the product's brand and prescription name (for example \"4C Labs Core PKS T29\").","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer, with the page to cite in \"source\"","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Too many requests"}}}},"/api/tools/cost":{"get":{"operationId":"estimate_yearly_cost","summary":"Estimate a first year's cost","description":"Work out a first year at a named clinic: its lowest fees, plus medication at list price if the amount on the patient's own prescription is given. Never suggests an amount.","parameters":[{"name":"clinic","in":"query","required":true,"description":"Clinic name or part of it.","schema":{"type":"string"}},{"name":"product","in":"query","required":false,"description":"Optional product \"slug\" from search_products.","schema":{"type":"string"}},{"name":"grams_per_month","in":"query","required":false,"description":"Optional. Grams per month on the patient's prescription. Ask the patient; do not guess.","schema":{"type":"number","exclusiveMinimum":0,"maximum":500}}],"responses":{"200":{"description":"The answer, with the page to cite in \"source\"","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Too many requests"}}}}}}