{"openapi":"3.1.0","info":{"title":"Disease & Public Health API","version":"1.0.0","description":"Global public-health data as an API, built on the open disease.sh dataset. Pull worldwide COVID-19 totals (cases, deaths, recovered, active, critical, tests and per-million rates), the same figures for any country (e.g. germany), continent (e.g. Europe) or US state (e.g. California), and the full sortable country list ranked by cases, deaths, tests and more. Track vaccine-coverage timelines globally or per country, and pull historical day-by-day case, death and recovery timelines for any country. Real data, no key needed upstream. Ideal for health dashboards, epidemiology research, data journalism and analytics.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/disease-api","description":"oanor gateway"}],"tags":[{"name":"Public Health"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/continent":{"get":{"operationId":"get_v1_continent","tags":["Public Health"],"summary":"Totals for a continent","description":"","parameters":[{"name":"continent","in":"query","required":true,"description":"Continent name, e.g. Europe","schema":{"type":"string"},"example":"Europe"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"continent":{"cases":253406198,"tests":2848046702,"active":2550270,"deaths":2101824,"updated":1780881454760,"critical":4453,"continent":"Europe","countries":["Albania","Andorra","Austria","Belarus","Belgium","Bosnia","Bulgaria","Channel Islands","Croatia","Czechia","Denmark","Estonia","Faroe Islands","Finland","France","Germany","Gibraltar","Greece","Holy See (Vatican City State)","Hungary","Iceland","Ireland","Isle of Man","Italy","Latvia","Liechtenstein","Lithuania","Luxembourg","Macedonia","Malta","Moldova","Monaco","Montenegro","Netherlands","Norway","Poland","Portugal","Romania","Russia","San Marino","Serbia","Slovakia","Slovenia","Spain","Sweden","Switzerland","UK","Ukraine"],"recovered":248754104,"population":747543837,"today_cases":0,"today_deaths":0,"today_recovered":474,"cases_per_million":338985.07,"tests_per_million":3809872.49,"deaths_per_million":2811.64}},"meta":{"timestamp":"2026-06-08T01:19:56.420Z","request_id":"5c791d15-26c6-4b01-a50a-54cdb10a6b27"},"status":"ok","message":"Continent retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/continents":{"get":{"operationId":"get_v1_continents","tags":["Public Health"],"summary":"All continents","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":6,"continents":[{"cases":131889132,"tests":1325710449,"active":2528062,"deaths":1695941,"updated":1780881454755,"critical":6095,"continent":"North America","countries":["Anguilla","Antigua and Barbuda","Aruba","Bahamas","Barbados","Belize","Bermuda","British Virgin Islands","Canada","Caribbean Netherlands","Cayman Islands","Costa Rica","Cuba","Curaçao","Dominica","Dominican Republic","El Salvador","Greenland","Grenada","Guadeloupe","Guatemala","Haiti","Honduras","Jamaica","Martinique","Mexico","Montserrat","Nicaragua","Panama","Saint Kitts and Nevis","Saint Lucia","Saint Martin","Saint Pierre Miquelon","Saint Vincent and the Grenadines","Sint Maarten","St. Barth","Trinidad and Tobago","Turks and Caicos Islands","USA"],"recovered":127665129,"population":598140916,"today_cases":0,"today_deaths":0,"today_recovered":350,"cases_per_million":220498.43,"tests_per_million":2216384.82,"deaths_per_million":2835.35},{"cases":221500265,"tests":2404652039,"active":14273512,"deaths":1553662,"updated":1780881454757,"critical":14733,"continent":"Asia","countries":["Afghanistan","Armenia","Azerbaijan","Bahrain","Bangladesh","Bhutan","Brunei","Cambodia","China","Cyprus","Georgia","Hong Kong","India","Indonesia","Iran","Iraq","Israel","Japan","Jordan","Kazakhstan","Kuwait","Kyrgyzstan","Lao People's Democratic Republic","Lebanon","Macao","Malaysia","Maldives","Mongolia","Myanmar","N. Korea","Nepal","Oman","Pakistan","Palestine","Philippines","Qatar","S. Korea","Saudi Arabia","Singapore","Sri Lanka","Syrian Arab Republic","Taiwan","Tajikistan","Thailand","Timor-Leste","Turkey","UAE","Uzbekistan","Vietnam","Yemen"],"recovered":205673091,"population":4711356783,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":47014.11,"tests_per_million":510394.81,"deaths_per_million":329.77},{"cases":253406198,"tests":2848046702,"active":2550270,"deaths":2101824,"updated":1780881454760,"critical":4453,"continent":"Europe","countries":["Albania","Andorra","Austria","Belarus","Belgium","Bosnia","Bulgaria","Channel Islands","Croatia","Czechia","Denmark","Estonia","Faroe Islands","Finland","France","Germany","Gibraltar","Greece","Holy See (Vatican City State)","Hungary","Iceland","Ireland","Isle of Man","Italy","Latvia","Liechtenstein","Lithuania","Luxembourg","Macedonia","Malta","Moldova","Monaco","Montenegro","Netherlands","Norway","Poland","Portugal","Romania","Russia","San Marino","Serbia","Slovakia","Slovenia","Spain","Sweden","Switzerland","UK","Ukraine"],"recovered":248754104,"population":747543837,"today_cases":0,"today_deaths":0,"today_recovered":474,"cases_per_million":338985.07,"tests_per_million":3809872.49,"deaths_per_million":2811.64},{"cases":70200879,"tests":245395353,"active":2149962,"deaths":1367332,"updated":1780881454761,"critical":8953,"continent":"South America","countries":["Argentina","Bolivia","Brazil","Chile","Colombia","Ecuador","Falkland Islands (Malvinas)","French Guiana","Guyana","Paraguay","Peru","Suriname","Uruguay","Venezuela"],"recovered":66683585,"population":437694443,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":160387.87,"tests_per_million":560654.49,"deaths_per_million":3123.94},{"cases":14895771,"tests":91668192,"active":110368,"deaths":33015,"updated":1780881454762,"critical":31,"continent":"Australia-Oceania","countries":["Australia","Cook Islands","Fiji","French Polynesia","Kiribati","Marshall Islands","Micronesia","Nauru","New Caledonia","New Zealand","Niue","Palau","Papua New Guinea","Samoa","Solomon Islands","Tokelau","Tonga","Tuvalu","Vanuatu","Wallis and Futuna"],"recovered":14752388,"population":43470408,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":342664.62,"tests_per_million":2108749.29,"deaths_per_million":759.48},{"cases":12860924,"tests":111032578,"active":511224,"deaths":258892,"updated":1780881454764,"critical":529,"continent":"Africa","countries":["Algeria","Angola","Benin","Botswana","Burkina Faso","Burundi","Cabo Verde","Cameroon","Central African Republic","Chad","Comoros","Congo","Côte d'Ivoire","DRC","Djibouti","Egypt","Equatorial Guinea","Eritrea","Ethiopia","Gabon","Gambia","Ghana","Guinea","Guinea-Bissau","Kenya","Lesotho","Liberia","Libyan Arab Jamahiriya","Madagascar","Malawi","Mali","Mauritania","Mauritius","Mayotte","Morocco","Mozambique","Namibia","Niger","Nigeria","Rwanda","Réunion","Saint Helena","Sao Tome and Principe","Senegal","Seychelles","Sierra Leone","Somalia","South Africa","South Sudan","Sudan","Swaziland","Tanzania","Togo","Tunisia","Uganda","Western Sahara","Zambia","Zimbabwe"],"recovered":12090808,"population":1406728744,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":9142.43,"tests_per_million":78929.63,"deaths_per_million":184.04}]},"meta":{"timestamp":"2026-06-08T01:19:56.523Z","request_id":"0d822193-203f-4b96-b91b-56f1b35c43f0"},"status":"ok","message":"Continents retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/countries":{"get":{"operationId":"get_v1_countries","tags":["Public Health"],"summary":"All countries, sortable","description":"","parameters":[{"name":"sort","in":"query","required":false,"description":"cases | deaths | tests | active | population | …","schema":{"type":"string"},"example":"cases"},{"name":"limit","in":"query","required":false,"description":"Results (1-250, default 50)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sort":"cases","count":50,"total":231,"countries":[{"flag":"https://disease.sh/assets/img/flags/us.png","iso2":"US","iso3":"USA","cases":111820082,"tests":1186851502,"active":786167,"deaths":1219487,"country":"USA","updated":1780881454448,"critical":940,"continent":"North America","recovered":109814428,"population":334805269,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":333985,"tests_per_million":3544901,"deaths_per_million":3642},{"flag":"https://disease.sh/assets/img/flags/in.png","iso2":"IN","iso3":"IND","cases":45035393,"tests":935879495,"active":44501823,"deaths":533570,"country":"India","updated":1780881454450,"critical":0,"continent":"Asia","recovered":0,"population":1406631776,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":32016,"tests_per_million":665334,"deaths_per_million":379},{"flag":"https://disease.sh/assets/img/flags/fr.png","iso2":"FR","iso3":"FRA","cases":40138560,"tests":271490188,"active":0,"deaths":167642,"country":"France","updated":1780881454453,"critical":0,"continent":"Europe","recovered":39970918,"population":65584518,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":612013,"tests_per_million":4139547,"deaths_per_million":2556},{"flag":"https://disease.sh/assets/img/flags/de.png","iso2":"DE","iso3":"DEU","cases":38828995,"tests":122332384,"active":405368,"deaths":183027,"country":"Germany","updated":1780881454455,"critical":0,"continent":"Europe","recovered":38240600,"population":83883596,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":462891,"tests_per_million":1458359,"deaths_per_million":2182},{"flag":"https://disease.sh/assets/img/flags/br.png","iso2":"BR","iso3":"BRA","cases":38743918,"tests":63776166,"active":1783377,"deaths":711380,"country":"Brazil","updated":1780881454458,"critical":0,"continent":"South America","recovered":36249161,"population":215353593,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":179908,"tests_per_million":296146,"deaths_per_million":3303},{"flag":"https://disease.sh/assets/img/flags/kr.png","iso2":"KR","iso3":"KOR","cases":34571873,"tests":15804065,"active":0,"deaths":35934,"country":"S. Korea","updated":1780881454460,"critical":0,"continent":"Asia","recovered":34535939,"population":51329899,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":673523,"tests_per_million":307892,"deaths_per_million":700},{"flag":"https://disease.sh/assets/img/flags/jp.png","iso2":"JP","iso3":"JPN","cases":33803572,"tests":100414883,"active":33728878,"deaths":74694,"country":"Japan","updated":1780881454462,"critical":0,"continent":"Asia","recovered":0,"population":125584838,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":269169,"tests_per_million":799578,"deaths_per_million":595},{"flag":"https://disease.sh/assets/img/flags/it.png","iso2":"IT","iso3":"ITA","cases":26723249,"tests":281126449,"active":165544,"deaths":196487,"country":"Italy","updated":1780881454464,"critical":22,"continent":"Europe","recovered":26361218,"population":60262770,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":443445,"tests_per_million":4665010,"deaths_per_million":3261},{"flag":"https://disease.sh/assets/img/flags/gb.png","iso2":"GB","iso3":"GBR","cases":24910387,"tests":522526476,"active":0,"deaths":232112,"country":"UK","updated":1780881454465,"critical":0,"continent":"Europe","recovered":24678275,"population":68497907,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":363666,"tests_per_million":7628357,"deaths_per_million":3389},{"flag":"https://disease.sh/assets/img/flags/ru.png","iso2":"RU","iso3":"RUS","cases":24124215,"tests":273400000,"active":175641,"deaths":402756,"country":"Russia","updated":1780881454468,"critical":0,"continent":"Europe","recovered":23545818,"population":145805947,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":165454,"tests_per_million":1875095,"deaths_per_million":2762},{"flag":"https://disease.sh/assets/img/flags/tr.png","iso2":"TR","iso3":"TUR","cases":17232066,"tests":162743369,"active":17129892,"deaths":102174,"country":"Turkey","updated":1780881454472,"critical":0,"continent":"Asia","recovered":0,"population":85561976,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":201399,"tests_per_million":1902052,"deaths_per_million":1194},{"flag":"https://disease.sh/assets/img/flags/es.png","iso2":"ES","iso3":"ESP","cases":13914811,"tests":471036328,"active":30634,"deaths":121760,"country":"Spain","updated":1780881454474,"critical":231,"continent":"Europe","recovered":13762417,"population":46719142,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":297840,"tests_per_million":10082298,"deaths_per_million":2606},{"flag":"https://disease.sh/assets/img/flags/au.png","iso2":"AU","iso3":"AUS","cases":11853144,"tests":81916639,"active":8716,"deaths":24414,"country":"Australia","updated":1780881454475,"critical":3,"continent":"Australia-Oceania","recovered":11820014,"population":26068792,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":454687,"tests_per_million":3142326,"deaths_per_million":937},{"flag":"https://disease.sh/assets/img/flags/vn.png","iso2":"VN","iso3":"VNM","cases":11625195,"tests":85826548,"active":941018,"deaths":43206,"country":"Vietnam","updated":1780881454476,"critical":0,"continent":"Asia","recovered":10640971,"population":98953541,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":117481,"tests_per_million":867342,"deaths_per_million":437},{"flag":"https://disease.sh/assets/img/flags/tw.png","iso2":"TW","iso3":"TWN","cases":10241523,"tests":30742304,"active":0,"deaths":19005,"country":"Taiwan","updated":1780881454478,"critical":0,"continent":"Asia","recovered":10222518,"population":23888595,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":428720,"tests_per_million":1286903,"deaths_per_million":796},{"flag":"https://disease.sh/assets/img/flags/ar.png","iso2":"AR","iso3":"ARG","cases":10128845,"tests":35716069,"active":746,"deaths":130841,"country":"Argentina","updated":1780881454480,"critical":0,"continent":"South America","recovered":9997258,"population":46010234,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":220143,"tests_per_million":776264,"deaths_per_million":2844},{"flag":"https://disease.sh/assets/img/flags/nl.png","iso2":"NL","iso3":"NLD","cases":8635786,"tests":25984435,"active":195,"deaths":22992,"country":"Netherlands","updated":1780881454482,"critical":0,"continent":"Europe","recovered":8612599,"population":17211447,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":501747,"tests_per_million":1509718,"deaths_per_million":1336},{"flag":"https://disease.sh/assets/img/flags/mx.png","iso2":"MX","iso3":"MEX","cases":7702809,"tests":20013810,"active":467986,"deaths":334958,"country":"Mexico","updated":1780881454484,"critical":0,"continent":"North America","recovered":6899865,"population":131562772,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":58549,"tests_per_million":152124,"deaths_per_million":2546},{"flag":"https://disease.sh/assets/img/flags/ir.png","iso2":"IR","iso3":"IRN","cases":7627186,"tests":57320267,"active":7480375,"deaths":146811,"country":"Iran","updated":1780881454486,"critical":0,"continent":"Asia","recovered":0,"population":86022837,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":88665,"tests_per_million":666338,"deaths_per_million":1707},{"flag":"https://disease.sh/assets/img/flags/id.png","iso2":"ID","iso3":"IDN","cases":6829221,"tests":114158919,"active":20054,"deaths":162063,"country":"Indonesia","updated":1780881454488,"critical":0,"continent":"Asia","recovered":6647104,"population":279134505,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":24466,"tests_per_million":408975,"deaths_per_million":581},{"flag":"https://disease.sh/assets/img/flags/pl.png","iso2":"PL","iso3":"POL","cases":6661991,"tests":39323709,"active":6541393,"deaths":120598,"country":"Poland","updated":1780881454489,"critical":0,"continent":"Europe","recovered":0,"population":37739785,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":176524,"tests_per_million":1041970,"deaths_per_million":3196},{"flag":"https://disease.sh/assets/img/flags/co.png","iso2":"CO","iso3":"COL","cases":6400173,"tests":36951507,"active":44821,"deaths":143200,"country":"Colombia","updated":1780881454491,"critical":342,"continent":"South America","recovered":6212152,"population":51512762,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":124244,"tests_per_million":717327,"deaths_per_million":2780},{"flag":"https://disease.sh/assets/img/flags/gr.png","iso2":"GR","iso3":"GRC","cases":6101379,"tests":102228365,"active":6063510,"deaths":37869,"country":"Greece","updated":1780881454493,"critical":0,"continent":"Europe","recovered":0,"population":10316637,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":591412,"tests_per_million":9909078,"deaths_per_million":3671},{"flag":"https://disease.sh/assets/img/flags/at.png","iso2":"AT","iso3":"AUT","cases":6081287,"tests":211273524,"active":3811,"deaths":22542,"country":"Austria","updated":1780881454495,"critical":0,"continent":"Europe","recovered":6054934,"population":9066710,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":670727,"tests_per_million":23302116,"deaths_per_million":2486},{"flag":"https://disease.sh/assets/img/flags/pt.png","iso2":"PT","iso3":"PRT","cases":5643062,"tests":46139518,"active":127,"deaths":28126,"country":"Portugal","updated":1780881454496,"critical":61,"continent":"Europe","recovered":5614809,"population":10140570,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":556484,"tests_per_million":4549993,"deaths_per_million":2774},{"flag":"https://disease.sh/assets/img/flags/ua.png","iso2":"UA","iso3":"UKR","cases":5557995,"tests":32603805,"active":0,"deaths":112418,"country":"Ukraine","updated":1780881454498,"critical":0,"continent":"Europe","recovered":5445577,"population":43192122,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":128681,"tests_per_million":754855,"deaths_per_million":2603},{"flag":"https://disease.sh/assets/img/flags/cl.png","iso2":"CL","iso3":"CHL","cases":5384853,"tests":50382097,"active":67906,"deaths":64497,"country":"Chile","updated":1780881454500,"critical":7,"continent":"South America","recovered":5252450,"population":19250195,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":279730,"tests_per_million":2617225,"deaths_per_million":3350},{"flag":"https://disease.sh/assets/img/flags/my.png","iso2":"MY","iso3":"MYS","cases":5278406,"tests":68580916,"active":7790,"deaths":37348,"country":"Malaysia","updated":1780881454502,"critical":11,"continent":"Asia","recovered":5233268,"population":33181072,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":159079,"tests_per_million":2066869,"deaths_per_million":1126},{"flag":"https://disease.sh/assets/img/flags/ca.png","iso2":"CA","iso3":"CAN","cases":4946090,"tests":66572774,"active":5744,"deaths":59034,"country":"Canada","updated":1780881454504,"critical":99,"continent":"North America","recovered":4881312,"population":38388419,"today_cases":0,"today_deaths":0,"today_recovered":350,"cases_per_million":128843,"tests_per_million":1734189,"deaths_per_million":1538},{"flag":"https://disease.sh/assets/img/flags/be.png","iso2":"BE","iso3":"BEL","cases":4861695,"tests":37454182,"active":521,"deaths":34376,"country":"Belgium","updated":1780881454505,"critical":0,"continent":"Europe","recovered":4826798,"population":11668278,"today_cases":0,"today_deaths":0,"today_recovered":50,"cases_per_million":416659,"tests_per_million":3209915,"deaths_per_million":2946},{"flag":"https://disease.sh/assets/img/flags/il.png","iso2":"IL","iso3":"ISR","cases":4841772,"tests":41373364,"active":30592,"deaths":12707,"country":"Israel","updated":1780881454507,"critical":0,"continent":"Asia","recovered":4798473,"population":9326000,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":519169,"tests_per_million":4436346,"deaths_per_million":1363},{"flag":"https://disease.sh/assets/img/flags/kp.png","iso2":"KP","iso3":"PRK","cases":4772813,"tests":0,"active":0,"deaths":74,"country":"N. Korea","updated":1780881454508,"critical":0,"continent":"Asia","recovered":4772739,"population":25990679,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":183636,"tests_per_million":0,"deaths_per_million":3},{"flag":"https://disease.sh/assets/img/flags/th.png","iso2":"TH","iso3":"THA","cases":4770149,"tests":17273454,"active":42927,"deaths":34586,"country":"Thailand","updated":1780881454510,"critical":0,"continent":"Asia","recovered":4692636,"population":70078203,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":68069,"tests_per_million":246488,"deaths_per_million":494},{"flag":"https://disease.sh/assets/img/flags/cz.png","iso2":"CZ","iso3":"CZE","cases":4759041,"tests":57834241,"active":318,"deaths":43517,"country":"Czechia","updated":1780881454514,"critical":2,"continent":"Europe","recovered":4715206,"population":10736784,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":443246,"tests_per_million":5386552,"deaths_per_million":4053},{"flag":"https://disease.sh/assets/img/flags/pe.png","iso2":"PE","iso3":"PER","cases":4572667,"tests":39010194,"active":0,"deaths":222161,"country":"Peru","updated":1780881454516,"critical":4,"continent":"South America","recovered":4350506,"population":33684208,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":135751,"tests_per_million":1158115,"deaths_per_million":6595},{"flag":"https://disease.sh/assets/img/flags/ch.png","iso2":"CH","iso3":"CHE","cases":4453053,"tests":23833472,"active":292,"deaths":14452,"country":"Switzerland","updated":1780881454518,"critical":0,"continent":"Europe","recovered":4438309,"population":8773637,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":507549,"tests_per_million":2716487,"deaths_per_million":1647},{"flag":"https://disease.sh/assets/img/flags/ph.png","iso2":"PH","iso3":"PHL","cases":4140383,"tests":36102746,"active":6138,"deaths":66864,"country":"Philippines","updated":1780881454520,"critical":0,"continent":"Asia","recovered":4067381,"population":112508994,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":36800,"tests_per_million":320888,"deaths_per_million":594},{"flag":"https://disease.sh/assets/img/flags/za.png","iso2":"ZA","iso3":"ZAF","cases":4076463,"tests":26795090,"active":61362,"deaths":102595,"country":"South Africa","updated":1780881454522,"critical":192,"continent":"Africa","recovered":3912506,"population":60756135,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":67095,"tests_per_million":441027,"deaths_per_million":1689},{"flag":"https://disease.sh/assets/img/flags/ro.png","iso2":"RO","iso3":"ROU","cases":3529735,"tests":28758667,"active":657,"deaths":68929,"country":"Romania","updated":1780881454523,"critical":21,"continent":"Europe","recovered":3460149,"population":19031335,"today_cases":0,"today_deaths":0,"today_recovered":390,"cases_per_million":185470,"tests_per_million":1511122,"deaths_per_million":3622},{"flag":"https://disease.sh/assets/img/flags/dk.png","iso2":"DK","iso3":"DNK","cases":3183756,"tests":129333107,"active":0,"deaths":8814,"country":"Denmark","updated":1780881454525,"critical":0,"continent":"Europe","recovered":3174942,"population":5834950,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":545636,"tests_per_million":22165247,"deaths_per_million":1511},{"flag":"https://disease.sh/assets/img/flags/sg.png","iso2":"SG","iso3":"SGP","cases":3006155,"tests":24756666,"active":0,"deaths":2024,"country":"Singapore","updated":1780881454526,"critical":4,"continent":"Asia","recovered":3004131,"population":5943546,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":505785,"tests_per_million":4165302,"deaths_per_million":341},{"flag":"https://disease.sh/assets/img/flags/hk.png","iso2":"HK","iso3":"HKG","cases":2937609,"tests":76127725,"active":6680,"deaths":14924,"country":"Hong Kong","updated":1780881454528,"critical":0,"continent":"Asia","recovered":2916005,"population":7604299,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":386309,"tests_per_million":10011143,"deaths_per_million":1963},{"flag":"https://disease.sh/assets/img/flags/se.png","iso2":"SE","iso3":"SWE","cases":2754129,"tests":19500873,"active":230,"deaths":27407,"country":"Sweden","updated":1780881454530,"critical":0,"continent":"Europe","recovered":2726492,"population":10218971,"today_cases":0,"today_deaths":0,"today_recovered":20,"cases_per_million":269511,"tests_per_million":1908301,"deaths_per_million":2682},{"flag":"https://disease.sh/assets/img/flags/nz.png","iso2":"NZ","iso3":"NZL","cases":2621111,"tests":7768604,"active":1623,"deaths":5697,"country":"New Zealand","updated":1780881454531,"critical":0,"continent":"Australia-Oceania","recovered":2613791,"population":4898203,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":535117,"tests_per_million":1586011,"deaths_per_million":1163},{"flag":"https://disease.sh/assets/img/flags/rs.png","iso2":"RS","iso3":"SRB","cases":2615054,"tests":13463733,"active":389,"deaths":18057,"country":"Serbia","updated":1780881454533,"critical":0,"continent":"Europe","recovered":2596608,"population":8653016,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":302213,"tests_per_million":1555958,"deaths_per_million":2087},{"flag":"https://disease.sh/assets/img/flags/iq.png","iso2":"IQ","iso3":"IRQ","cases":2465545,"tests":19544451,"active":673,"deaths":25375,"country":"Iraq","updated":1780881454535,"critical":0,"continent":"Asia","recovered":2439497,"population":42164965,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":58474,"tests_per_million":463523,"deaths_per_million":602},{"flag":"https://disease.sh/assets/img/flags/hu.png","iso2":"HU","iso3":"HUN","cases":2230232,"tests":11394556,"active":29029,"deaths":49048,"country":"Hungary","updated":1780881454537,"critical":0,"continent":"Europe","recovered":2152155,"population":9606259,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":232164,"tests_per_million":1186160,"deaths_per_million":5106},{"flag":"https://disease.sh/assets/img/flags/bd.png","iso2":"BD","iso3":"BGD","cases":2049377,"tests":15254399,"active":2019884,"deaths":29493,"country":"Bangladesh","updated":1780881454539,"critical":0,"continent":"Asia","recovered":0,"population":167885689,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":12207,"tests_per_million":90862,"deaths_per_million":176},{"flag":"https://disease.sh/assets/img/flags/sk.png","iso2":"SK","iso3":"SVK","cases":1877605,"tests":7448789,"active":0,"deaths":21224,"country":"Slovakia","updated":1780881454540,"critical":23,"continent":"Europe","recovered":1856381,"population":5460193,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":343872,"tests_per_million":1364199,"deaths_per_million":3887},{"flag":"https://disease.sh/assets/img/flags/ge.png","iso2":"GE","iso3":"GEO","cases":1861665,"tests":16920079,"active":1844533,"deaths":17132,"country":"Georgia","updated":1780881454542,"critical":0,"continent":"Asia","recovered":0,"population":3968738,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":469082,"tests_per_million":4263340,"deaths_per_million":4317}]},"meta":{"timestamp":"2026-06-08T01:19:56.664Z","request_id":"71b2eea3-d8ea-4937-bec3-e080e80ecc16"},"status":"ok","message":"Countries retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/country":{"get":{"operationId":"get_v1_country","tags":["Public Health"],"summary":"Totals for a country","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"Country name or ISO code, e.g. germany","schema":{"type":"string"},"example":"germany"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"country":{"flag":"https://disease.sh/assets/img/flags/de.png","iso2":"DE","iso3":"DEU","cases":38828995,"tests":122332384,"active":405368,"deaths":183027,"country":"Germany","updated":1780881454455,"critical":0,"continent":"Europe","recovered":38240600,"population":83883596,"today_cases":0,"today_deaths":0,"today_recovered":0,"cases_per_million":462891,"tests_per_million":1458359,"deaths_per_million":2182}},"meta":{"timestamp":"2026-06-08T01:19:56.788Z","request_id":"09b6a1e8-49d0-465c-9ece-8572d3354529"},"status":"ok","message":"Country retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/global":{"get":{"operationId":"get_v1_global","tags":["Public Health"],"summary":"Worldwide totals","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"cases":704753890,"scope":"global","tests":7026505313,"active":22123398,"deaths":7010681,"updated":1780881454446,"critical":34794,"recovered":675619811,"population":7944935131,"today_cases":0,"today_deaths":0,"today_recovered":790,"cases_per_million":90413,"tests_per_million":884400.59,"deaths_per_million":899.4},"meta":{"timestamp":"2026-06-08T01:19:56.886Z","request_id":"aba17492-39bf-40ee-8733-a00e3cbf33ef"},"status":"ok","message":"Global totals retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/historical":{"get":{"operationId":"get_v1_historical","tags":["Public Health"],"summary":"Historical case/death timeline","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"Country name, e.g. germany","schema":{"type":"string"},"example":"germany"},{"name":"lastdays","in":"query","required":false,"description":"Days of history (default 30)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":30,"country":"Germany","province":["mainland"],"timeline":[{"date":"2/8/23","cases":37879714,"deaths":166526,"recovered":0},{"date":"2/9/23","cases":37893892,"deaths":166660,"recovered":0},{"date":"2/10/23","cases":37893892,"deaths":166660,"recovered":0},{"date":"2/11/23","cases":37907312,"deaths":166763,"recovered":0},{"date":"2/12/23","cases":37907312,"deaths":166763,"recovered":0},{"date":"2/13/23","cases":37928944,"deaths":166875,"recovered":0},{"date":"2/14/23","cases":37949446,"deaths":166999,"recovered":0},{"date":"2/15/23","cases":37970357,"deaths":167124,"recovered":0},{"date":"2/16/23","cases":37986750,"deaths":167214,"recovered":0},{"date":"2/17/23","cases":38002114,"deaths":167301,"recovered":0},{"date":"2/18/23","cases":38002114,"deaths":167301,"recovered":0},{"date":"2/19/23","cases":38002114,"deaths":167301,"recovered":0},{"date":"2/20/23","cases":38018111,"deaths":167387,"recovered":0},{"date":"2/21/23","cases":38043874,"deaths":167491,"recovered":0},{"date":"2/22/23","cases":38068912,"deaths":167604,"recovered":0},{"date":"2/23/23","cases":38090089,"deaths":167723,"recovered":0},{"date":"2/24/23","cases":38111063,"deaths":167812,"recovered":0},{"date":"2/25/23","cases":38111063,"deaths":167812,"recovered":0},{"date":"2/26/23","cases":38111063,"deaths":167812,"recovered":0},{"date":"2/27/23","cases":38144033,"deaths":167951,"recovered":0},{"date":"2/28/23","cases":38168908,"deaths":168086,"recovered":0},{"date":"3/1/23","cases":38189954,"deaths":168175,"recovered":0},{"date":"3/2/23","cases":38202571,"deaths":168296,"recovered":0},{"date":"3/3/23","cases":38210850,"deaths":168397,"recovered":0},{"date":"3/4/23","cases":38210850,"deaths":168397,"recovered":0},{"date":"3/5/23","cases":38210851,"deaths":168397,"recovered":0},{"date":"3/6/23","cases":38210851,"deaths":168397,"recovered":0},{"date":"3/7/23","cases":38231610,"deaths":168709,"recovered":0},{"date":"3/8/23","cases":38241231,"deaths":168808,"recovered":0},{"date":"3/9/23","cases":38249060,"deaths":168935,"recovered":0}]},"meta":{"timestamp":"2026-06-08T01:19:57.346Z","request_id":"5a19dac5-0e5e-40a1-8940-e7cdd33daf3c"},"status":"ok","message":"Historical timeline retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/states":{"get":{"operationId":"get_v1_states","tags":["Public Health"],"summary":"US states (all, or one)","description":"","parameters":[{"name":"state","in":"query","required":false,"description":"US state name, e.g. California (omit for all)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":63,"states":[{"cases":12711918,"state":"California","deaths":112443,"updated":1780881454275,"recovered":0,"population":39512223,"cases_per_million":321721,"deaths_per_million":2846},{"cases":9190299,"state":"Texas","deaths":104793,"updated":1780881454275,"recovered":0,"population":28995881,"cases_per_million":316952,"deaths_per_million":3614},{"cases":8048191,"state":"Florida","deaths":95206,"updated":1780881454275,"recovered":0,"population":21477737,"cases_per_million":374722,"deaths_per_million":4433},{"cases":7587861,"state":"New York","deaths":83374,"updated":1780881454275,"recovered":0,"population":19453561,"cases_per_million":390050,"deaths_per_million":4286},{"cases":4136659,"state":"Illinois","deaths":42005,"updated":1780881454275,"recovered":0,"population":12671821,"cases_per_million":326446,"deaths_per_million":3315},{"cases":3741277,"state":"Ohio","deaths":43896,"updated":1780881454275,"recovered":3684603,"population":11689100,"cases_per_million":320065,"deaths_per_million":3755},{"cases":3565499,"state":"Pennsylvania","deaths":51480,"updated":1780881454275,"recovered":0,"population":12801989,"cases_per_million":278511,"deaths_per_million":4021},{"cases":3501404,"state":"North Carolina","deaths":29059,"updated":1780881454275,"recovered":0,"population":10488084,"cases_per_million":333846,"deaths_per_million":2771},{"cases":3306221,"state":"Michigan","deaths":44762,"updated":1780881454276,"recovered":0,"population":9986857,"cases_per_million":331057,"deaths_per_million":4482},{"cases":3295020,"state":"New Jersey","deaths":36873,"updated":1780881454276,"recovered":0,"population":8882190,"cases_per_million":370969,"deaths_per_million":4151},{"cases":3287483,"state":"Georgia","deaths":44069,"updated":1780881454276,"recovered":0,"population":10617423,"cases_per_million":309631,"deaths_per_million":4151},{"cases":2729641,"state":"Tennessee","deaths":30729,"updated":1780881454276,"recovered":0,"population":6829174,"cases_per_million":399703,"deaths_per_million":4500},{"cases":2607545,"state":"Arizona","deaths":34402,"updated":1780881454276,"recovered":0,"population":7278717,"cases_per_million":358242,"deaths_per_million":4726},{"cases":2367542,"state":"Massachusetts","deaths":25586,"updated":1780881454276,"recovered":0,"population":6892503,"cases_per_million":343495,"deaths_per_million":3712},{"cases":2315784,"state":"Virginia","deaths":23748,"updated":1780881454276,"recovered":0,"population":8535519,"cases_per_million":271311,"deaths_per_million":2782},{"cases":2208419,"state":"Indiana","deaths":28018,"updated":1780881454276,"recovered":0,"population":6732219,"cases_per_million":328037,"deaths_per_million":4162},{"cases":2070848,"state":"Washington","deaths":17339,"updated":1780881454276,"recovered":0,"population":7614893,"cases_per_million":271947,"deaths_per_million":2277},{"cases":2043838,"state":"Wisconsin","deaths":16758,"updated":1780881454276,"recovered":0,"population":5822434,"cases_per_million":351028,"deaths_per_million":2878},{"cases":1900794,"state":"Minnesota","deaths":16458,"updated":1780881454276,"recovered":0,"population":5639632,"cases_per_million":337042,"deaths_per_million":2918},{"cases":1874746,"state":"Colorado","deaths":15552,"updated":1780881454276,"recovered":0,"population":5758736,"cases_per_million":325548,"deaths_per_million":2701},{"cases":1857853,"state":"South Carolina","deaths":20311,"updated":1780881454276,"recovered":0,"population":5148714,"cases_per_million":360838,"deaths_per_million":3945},{"cases":1808735,"state":"Kentucky","deaths":19183,"updated":1780881454276,"recovered":0,"population":4467673,"cases_per_million":404849,"deaths_per_million":4294},{"cases":1780715,"state":"Missouri","deaths":22778,"updated":1780881454276,"recovered":0,"population":6137428,"cases_per_million":290140,"deaths_per_million":3711},{"cases":1684058,"state":"Louisiana","deaths":19270,"updated":1780881454276,"recovered":0,"population":4648794,"cases_per_million":362257,"deaths_per_million":4145},{"cases":1659936,"state":"Alabama","deaths":21138,"updated":1780881454276,"recovered":0,"population":4903185,"cases_per_million":338542,"deaths_per_million":4311},{"cases":1451442,"state":"Maryland","deaths":17929,"updated":1780881454276,"recovered":0,"population":6045680,"cases_per_million":240079,"deaths_per_million":2966},{"cases":1306350,"state":"Oklahoma","deaths":16157,"updated":1780881454276,"recovered":1288527,"population":3956971,"cases_per_million":330139,"deaths_per_million":4083},{"cases":1137615,"state":"Utah","deaths":5719,"updated":1780881454276,"recovered":0,"population":3205958,"cases_per_million":354844,"deaths_per_million":1784},{"cases":1062606,"state":"Arkansas","deaths":13246,"updated":1780881454276,"recovered":0,"population":3017804,"cases_per_million":352112,"deaths_per_million":4389},{"cases":1058274,"state":"Iowa","deaths":10797,"updated":1780881454276,"recovered":0,"population":3155070,"cases_per_million":335420,"deaths_per_million":3422},{"cases":1000415,"state":"Mississippi","deaths":13474,"updated":1780881454276,"recovered":0,"population":2976149,"cases_per_million":336144,"deaths_per_million":4527},{"cases":992925,"state":"Oregon","deaths":9764,"updated":1780881454276,"recovered":0,"population":4217737,"cases_per_million":235417,"deaths_per_million":2315},{"cases":983652,"state":"Connecticut","deaths":12354,"updated":1780881454276,"recovered":0,"population":3565287,"cases_per_million":275897,"deaths_per_million":3465},{"cases":946564,"state":"Kansas","deaths":10229,"updated":1780881454276,"recovered":934730,"population":2913314,"cases_per_million":324910,"deaths_per_million":3511},{"cases":923059,"state":"Nevada","deaths":12485,"updated":1780881454276,"recovered":0,"population":3080156,"cases_per_million":299679,"deaths_per_million":4053},{"cases":725653,"state":"New Mexico","deaths":9623,"updated":1780881454276,"recovered":0,"population":2096829,"cases_per_million":346072,"deaths_per_million":4589},{"cases":703856,"state":"West Virginia","deaths":8247,"updated":1780881454276,"recovered":0,"population":1792147,"cases_per_million":392745,"deaths_per_million":4602},{"cases":574399,"state":"Nebraska","deaths":5063,"updated":1780881454276,"recovered":566979,"population":1934408,"cases_per_million":296938,"deaths_per_million":2617},{"cases":525825,"state":"Idaho","deaths":5482,"updated":1780881454276,"recovered":0,"population":1787065,"cases_per_million":294239,"deaths_per_million":3068},{"cases":443803,"state":"Rhode Island","deaths":4166,"updated":1780881454276,"recovered":0,"population":1059361,"cases_per_million":418935,"deaths_per_million":3933},{"cases":418369,"state":"Hawaii","deaths":2167,"updated":1780881454276,"recovered":0,"population":1415872,"cases_per_million":295485,"deaths_per_million":1531},{"cases":382013,"state":"New Hampshire","deaths":3329,"updated":1780881454276,"recovered":0,"population":1359711,"cases_per_million":280952,"deaths_per_million":2448},{"cases":350706,"state":"Delaware","deaths":3663,"updated":1780881454276,"recovered":0,"population":973764,"cases_per_million":360155,"deaths_per_million":3762},{"cases":346182,"state":"Maine","deaths":3394,"updated":1780881454276,"recovered":0,"population":1344212,"cases_per_million":257535,"deaths_per_million":2525},{"cases":333758,"state":"Montana","deaths":3712,"updated":1780881454276,"recovered":329725,"population":1068778,"cases_per_million":312280,"deaths_per_million":3473},{"cases":309990,"state":"North Dakota","deaths":2513,"updated":1780881454276,"recovered":0,"population":762062,"cases_per_million":406778,"deaths_per_million":3298},{"cases":301513,"state":"Alaska","deaths":1485,"updated":1780881454276,"recovered":0,"population":731545,"cases_per_million":412159,"deaths_per_million":2030},{"cases":282895,"state":"South Dakota","deaths":3231,"updated":1780881454277,"recovered":0,"population":884659,"cases_per_million":319779,"deaths_per_million":3652},{"cases":196126,"state":"Wyoming","deaths":2126,"updated":1780881454277,"recovered":0,"population":578759,"cases_per_million":338873,"deaths_per_million":3673},{"cases":178747,"state":"District Of Columbia","deaths":1434,"updated":1780881454277,"recovered":0,"population":705749,"cases_per_million":253273,"deaths_per_million":2032},{"cases":155080,"state":"Vermont","deaths":1139,"updated":1780881454277,"recovered":0,"population":623989,"cases_per_million":248530,"deaths_per_million":1825},{"cases":1473460,"state":"Puerto Rico","deaths":7326,"updated":1780881454277,"recovered":0,"population":3386941,"cases_per_million":435042,"deaths_per_million":2163},{"cases":61139,"state":"Guam","deaths":420,"updated":1780881454277,"recovered":60681,"population":0,"cases_per_million":0,"deaths_per_million":0},{"cases":26148,"state":"United States Virgin Islands","deaths":133,"updated":1780881454277,"recovered":26002,"population":0,"cases_per_million":0,"deaths_per_million":0},{"cases":14341,"state":"Northern Mariana Islands","deaths":41,"updated":1780881454277,"recovered":0,"population":0,"cases_per_million":0,"deaths_per_million":0},{"cases":8359,"state":"American Samoa","deaths":34,"updated":1780881454277,"recovered":0,"population":0,"cases_per_million":0,"deaths_per_million":0},{"cases":958962,"state":"Veteran Affairs","deaths":26087,"updated":1780881454277,"recovered":931580,"population":0,"cases_per_million":0,"deaths_per_million":0},{"cases":742808,"state":"US Military","deaths":689,"updated":1780881454277,"recovered":0,"population":0,"cases_per_million":0,"deaths_per_million":0},{"cases":89106,"state":"Navajo Nation","deaths":2268,"updated":1780881454277,"recovered":0,"population":0,"cases_per_million":0,"deaths_per_million":0},{"cases":71485,"state":"Federal Prisons","deaths":324,"updated":1780881454277,"recovered":0,"population":0,"cases_per_million":0,"deaths_per_million":0},{"cases":122,"state":"Grand Princess Ship","deaths":7,"updated":1780881454277,"recovered":115,"population":0,"cases_per_million":0,"deaths_per_million":0},{"cases":3,"state":"Wuhan Repatriated","deaths":0,"updated":1780881454278,"recovered":3,"population":0,"cases_per_million":0,"deaths_per_million":0},{"cases":46,"state":"Diamond Princess Ship","deaths":0,"updated":1780881454278,"recovered":46,"population":0,"cases_per_million":0,"deaths_per_million":0}]},"meta":{"timestamp":"2026-06-08T01:19:57.452Z","request_id":"3b8489db-0c80-4ccd-847f-7ad089f0330f"},"status":"ok","message":"States retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/vaccine":{"get":{"operationId":"get_v1_vaccine","tags":["Public Health"],"summary":"Vaccine-coverage timeline","description":"","parameters":[{"name":"country","in":"query","required":false,"description":"Country (omit for global)","schema":{"type":"string"},"example":"germany"},{"name":"lastdays","in":"query","required":false,"description":"Days of history (default 30)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":30,"country":"Germany","timeline":[{"date":"6/22/25","doses":192221468},{"date":"6/23/25","doses":192221468},{"date":"6/24/25","doses":192221468},{"date":"6/25/25","doses":192221468},{"date":"6/26/25","doses":192221468},{"date":"6/27/25","doses":192221468},{"date":"6/28/25","doses":192221468},{"date":"6/29/25","doses":192221468},{"date":"6/30/25","doses":192221468},{"date":"7/1/25","doses":192221468},{"date":"7/2/25","doses":192221468},{"date":"7/3/25","doses":192221468},{"date":"7/4/25","doses":192221468},{"date":"7/5/25","doses":192221468},{"date":"7/6/25","doses":192221468},{"date":"7/7/25","doses":192221468},{"date":"7/8/25","doses":192221468},{"date":"7/9/25","doses":192221468},{"date":"7/10/25","doses":192221468},{"date":"7/11/25","doses":192221468},{"date":"7/12/25","doses":192221468},{"date":"7/13/25","doses":192221468},{"date":"7/14/25","doses":192221468},{"date":"7/15/25","doses":192221468},{"date":"7/16/25","doses":192221468},{"date":"7/17/25","doses":192221468},{"date":"7/18/25","doses":192221468},{"date":"7/19/25","doses":192221468},{"date":"7/20/25","doses":192221468},{"date":"7/21/25","doses":192221468}]},"meta":{"timestamp":"2026-06-08T01:19:58.008Z","request_id":"bb9e66b4-e106-4974-9f05-c642a365458e"},"status":"ok","message":"Vaccine coverage retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service description & endpoints","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"service":"disease-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/global":"Worldwide totals.","GET /v1/states":"US states (all, or state=California).","GET /v1/country":"Totals for a country (country=germany).","GET /v1/vaccine":"Vaccine-coverage timeline (global, or country=).","GET /v1/continent":"Totals for a continent (continent=Europe).","GET /v1/countries":"All countries (sort=cases|deaths|tests|…, limit=).","GET /v1/continents":"All continents.","GET /v1/historical":"Historical case/death timeline (country=, lastdays=)."},"description":"Global public-health data via disease.sh: worldwide and per-country, per-continent and per-US-state COVID-19 totals, the full sortable country list, vaccine-coverage timelines and historical case/death timelines. Real data, no key."},"meta":{"timestamp":"2026-06-08T01:19:58.110Z","request_id":"92814d81-e65d-4307-acf2-649f704a4ab0"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":6000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":700,"monthly_call_quota":90000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2400,"monthly_call_quota":500000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7900,"monthly_call_quota":2500000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/disease-api"}