{"openapi":"3.1.0","info":{"title":"AthenaDS Solutions API","version":"2.2.0","description":"What Medicare paid US hospitals, service by service, with CMS quality ratings — compiled from official CMS open data. Amounts are published averages for a stated year: benchmarks, not quotes. Without a key, each call returns up to 3 rows (60 calls an hour). With a key, up to 100 rows per call: a Developer API plan includes a number of calls each month and prices each call after that; a license key answers for the states its license covers. See https://athenadssolutions.com/pricing.html.","termsOfService":"https://athenadssolutions.com/api-license.html","contact":{"url":"https://athenadssolutions.com/contact.html"}},"servers":[{"url":"https://athenadssolutions.com"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}}},"security":[{},{"bearer":[]}],"externalDocs":{"description":"Guide for AI assistants and developers","url":"https://athenadssolutions.com/ai.html"},"paths":{"/api/v1/prices":{"get":{"operationId":"searchPrices","summary":"Search payment figures by service, hospital, city or state","parameters":[{"name":"q","in":"query","description":"Free text: everyday name of a stay or procedure, a hospital or a city","schema":{"type":"string"}},{"name":"code","in":"query","description":"DRG or APC code, e.g. 470 or \"APC 5491\"","schema":{"type":"string"}},{"name":"state","in":"query","description":"Two-letter state code or name","schema":{"type":"string"}},{"name":"city","in":"query","description":"City name","schema":{"type":"string"}},{"name":"kind","in":"query","description":"drg (hospital stays) or apc (outpatient)","schema":{"type":"string","enum":["drg","apc"]}},{"name":"sort","in":"query","description":"low, high, volume or hospital","schema":{"type":"string"}},{"name":"limit","in":"query","description":"Rows to return","schema":{"type":"integer"}},{"name":"offset","in":"query","description":"Rows to skip (with a key)","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"403":{"description":"The key is not active, or the state asked for is outside the license"},"429":{"description":"Free-tier rate limit reached, or the month's included calls are used — the answer says how to add calls"}}}},"/api/v1/compare":{"get":{"operationId":"compareProcedure","summary":"Low, median, high and quartiles for one service","parameters":[{"name":"code","in":"query","description":"DRG or APC code","schema":{"type":"string"},"required":true},{"name":"state","in":"query","description":"Two-letter state code or name","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"403":{"description":"The key is not active, or the state asked for is outside the license"},"429":{"description":"Free-tier rate limit reached, or the month's included calls are used — the answer says how to add calls"}}}},"/api/v1/services":{"get":{"operationId":"listServices","summary":"Service groups with national figures","parameters":[{"name":"q","in":"query","description":"Filter by words","schema":{"type":"string"}},{"name":"kind","in":"query","description":"drg or apc","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"403":{"description":"The key is not active, or the state asked for is outside the license"},"429":{"description":"Free-tier rate limit reached, or the month's included calls are used — the answer says how to add calls"}}}},"/api/v1/hospitals":{"get":{"operationId":"searchHospitals","summary":"Search hospitals","parameters":[{"name":"q","in":"query","description":"Name or city","schema":{"type":"string"}},{"name":"state","in":"query","description":"Two-letter state code or name","schema":{"type":"string"}},{"name":"limit","in":"query","description":"Rows to return","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"403":{"description":"The key is not active, or the state asked for is outside the license"},"429":{"description":"Free-tier rate limit reached, or the month's included calls are used — the answer says how to add calls"}}}},"/api/v1/hospitals/{ccn}":{"get":{"operationId":"hospitalProfile","summary":"Hospital profile by CMS Certification Number","parameters":[{"name":"ccn","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"403":{"description":"The key is not active, or the state asked for is outside the license"},"404":{"description":"Hospital not found"},"429":{"description":"Free-tier rate limit reached, or the month's included calls are used — the answer says how to add calls"}}}},"/api/v1/states":{"get":{"operationId":"listStates","summary":"States with hospital and figure counts","responses":{"200":{"description":"OK"},"403":{"description":"The key is not active, or the state asked for is outside the license"},"429":{"description":"Free-tier rate limit reached, or the month's included calls are used — the answer says how to add calls"}}}},"/api/v1/search":{"get":{"operationId":"searchRecords","summary":"Search supporting reference records (FDA, ICD-10, trials, public health)","parameters":[{"name":"q","in":"query","description":"Words to find","schema":{"type":"string"}},{"name":"category","in":"query","description":"Record category","schema":{"type":"string"}},{"name":"state","in":"query","description":"State","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"403":{"description":"The key is not active, or the state asked for is outside the license"},"429":{"description":"Free-tier rate limit reached, or the month's included calls are used — the answer says how to add calls"}}}},"/api/v1/stats":{"get":{"operationId":"datasetStats","summary":"Dataset counts and coverage","responses":{"200":{"description":"OK"},"403":{"description":"The key is not active, or the state asked for is outside the license"},"429":{"description":"Free-tier rate limit reached, or the month's included calls are used — the answer says how to add calls"}}}},"/api/v1/sources":{"get":{"operationId":"listSources","summary":"Dataset sources","responses":{"200":{"description":"OK"},"403":{"description":"The key is not active, or the state asked for is outside the license"},"429":{"description":"Free-tier rate limit reached, or the month's included calls are used — the answer says how to add calls"}}}}}}