Subnational COVID-19 vaccination data

API | Download data | GitHub

refresh GitHub last commit Website link! API link!

Follow @sociepy Star Fork

COVID-19 vaccination data at subnational level. To ensure its officiality, the source data is carefully verified.

All country data can be found in a single csv file. If you are interested in indiviual country data, you may want to check countries folder.

Additionally, we provide a static API endpoint, which contains the data per country as JSONs. For more details check here.

Thanks to

This project is inspired by wonderful project owid/covid-19-data, adopting some of its structure, and is open to integration if deemed appropriate. In addition, thanks to all of the people involved in the different source data initiatives.


Data sources

This project wouldnโ€™t be possible without the great resources available online.

Country Source 2-Dose Last update
๐Ÿ‡ช๐Ÿ‡ธ Spain โœ… 2021-12-16
๐Ÿ‡บ๐Ÿ‡พ Uruguay โœ… 2021-12-16
๐Ÿ‡ง๐Ÿ‡ท Brazil โœ… 2021-12-16
๐Ÿ‡ฆ๐Ÿ‡บ Australia โŒ 2021-12-16
๐Ÿ‡ฆ๐Ÿ‡ท Argentina โœ… 2021-12-16
๐Ÿ‡ฎ๐Ÿ‡น Italy โœ… 2021-12-15
๐Ÿ‡จ๐Ÿ‡ฆ Canada โœ… 2021-12-15
๐Ÿ‡ฌ๐Ÿ‡ง United Kingdom โœ… 2021-12-15
๐Ÿ‡ซ๐Ÿ‡ท France โœ… 2021-12-15
๐Ÿ‡ฉ๐Ÿ‡ช Germany โœ… 2021-12-15
๐Ÿ‡ธ๐Ÿ‡ฐ Slovakia โœ… 2021-12-15
๐Ÿ‡ง๐Ÿ‡ช Belgium โœ… 2021-12-14
๐Ÿ‡ฆ๐Ÿ‡น Austria โœ… 2021-12-14
๐Ÿ‡ฉ๐Ÿ‡ฐ Denmark โœ… 2021-12-14
๐Ÿ‡ธ๐Ÿ‡ช Sweden โœ… 2021-11-07
๐Ÿ‡ฑ๐Ÿ‡ง Lebanon โŒ 2021-10-26
๐Ÿ‡ณ๐Ÿ‡ด Norway โœ… 2021-10-18
๐Ÿ‡ฐ๐Ÿ‡ท Korea โœ… 2021-10-12
๐Ÿ‡จ๐Ÿ‡ฟ Czechia โœ… 2021-09-19
๐Ÿ‡ท๐Ÿ‡บ Russia โœ… 2021-09-11
๐Ÿ‡น๐Ÿ‡ท Turkey โœ… 2021-08-25
๐Ÿ‡ซ๐Ÿ‡ฎ Finland โœ… 2021-07-20
๐Ÿ‡จ๐Ÿ‡ฑ Chile โœ… 2021-07-15
๐Ÿ‡ต๐Ÿ‡ช Peru โŒ 2021-06-14
๐Ÿ‡ฎ๐Ÿ‡ธ Iceland โœ… 2021-05-11
๐Ÿ‡บ๐Ÿ‡ฆ Ukraine โœ… 2021-05-07
๐Ÿ‡ฎ๐Ÿ‡ณ India โœ… 2021-05-03
๐Ÿ‡จ๐Ÿ‡ญ Switzerland โœ… 2021-04-04
๐Ÿ‡บ๐Ÿ‡ธ United States โœ… 2021-03-07
๐Ÿ‡ต๐Ÿ‡ฑ Poland โœ… 2021-02-11

Data format

The data pretends to resemble the API proposed by owid/covid-19-data. Find below the field description, mainly provided by OWID.

Field Description
location Name of the country.
region Name of the subnational region of the country.
date Date of the observation.
location_iso ISO 3166-1 country codes (XX)
region_iso ISO 3166-2 region codes (XX-YY or XX-YYY).
total_vaccinations Total number of doses administered. This is counted as a single dose, and may not equal the total number of people vaccinated, depending on the specific dose regime (e.g. people receive multiple doses). If a person receives one dose of the vaccine, this metric goes up by 1. If they receive a second dose, it goes up by 1 again.
people_vaccinated Total number of people who received at least one vaccine dose. If a person receives the first dose of a 2-dose vaccine, this metric goes up by 1. If they receive the second dose, the metric stays the same.
people_fully_vaccinated Total number of people who received all doses prescribed by the vaccination protocol. If a person receives the first dose of a 2-dose vaccine, this metric stays the same. If they receive the second dose, the metric goes up by 1.
total_vaccinations_per_100 total_vaccinations per 100 habitants.
people_vaccinated_per_100 people_vaccinated per 100 habitants.
people_fully_vaccinated_per_100 people_fully_vaccinated per 100 habitants.

Note: for people_vaccinated and people_fully_vaccinated we are dependent on the necessary data being made available, so we may not be able to make these metrics available for some countries.


The updates are done using script. For more details on the scripts being used, check here.

Set up environment

Install the package:

$ pip install -e .

Execute update

$ bash scripts/

Add new countries

New: Use this notebook as a guideline on how to add a new country scraper!

If you know of any reference publishing vaccination regional data for other countries, your contribution is very much appreciated! It is extremely helpfull if you could report this in the issues. Also, if you feel like automating it by yourself (thatโ€™d be awesome!), please fork this repository and issue a pull request with your changes.

The country scraping logic lives within the package module, specifically in covid_updater.scraping. More details to be added here soon.


We do our best to ensure that the data is reliable. However, as the project grows and source website change their format, some bugs might appear. If you detect any, please report this in the issues section.


See documentation (WIP ๐Ÿšง)



This site or product includes IP2Locationโ„ข ISO 3166-2 Subdivision Code which available from