March 26, 2020

465 words 3 mins read



COVID 19 Data and Dashboard for South Africa

repo name dsfsi/covid19za
repo link
language Jupyter Notebook
size (curr.) 19883 kB
stars (curr.) 90
created 2020-03-13
license MIT License

Coronavirus COVID-19 (2019-nCoV) Data Repository for South Africa


COVID 19 Data for South Africa created, maintained and hosted by Data Science for Social Impact research group, led by Dr. Vukosi Marivate, at the University of Pretoria.

Disclaimer: We have worked to keep the data as accurate as possible. We collate the COVID 19 reporting data from NICD and DoH. We only update that data once there is an official report or statement. For the other data, we work to keep the data as accurate as possible. If you find errors. Make a pull request.

If you use this repo for any research/development/innovation, please contact us (see contacts below)

See our blog posts:

If you are interested in the Africa-wide effort: Go to

For information on daily updates on the repo, go to


Code License: MIT | Data License: CC BY-SA 4.0

Data Available [/data]

NOTE: Since around 24 March, we have not gotten individual case data from DoH or NICD. For now if you need provincial counts use the provincial_cumulative_timeline. For indivividual cases up to 25 March, use the confirmed_cases.

dataset url raw_url[file]
provincial_cumulative_timeline provincial_cumulative_timeline provincial_cumulative_timeline.csv
confirmed_cases covid19za_timeline_confirmed covid19za_timeline_confirmed.csv
deaths covid19za_timeline_deaths covid19za_timeline_deaths.csv
transmission_type covid19za_timeline_transmission_type covid19za_timeline_transmission_type.csv
testing covid19za_timeline_testing covid19za_timeline_testing.csv
DoH PDFs and Extracted CSVs doh_pdf
DoH Whatsapp case update archive doh_whatsapp
public_hospitals [validation in progress] health_system_za_public_hospitals health_system_za_public_hospitals.csv


Data Sources:

  • NICD - South Africa URL
  • Department of Health - South Africa Main Site, Twitter
  • South African Government Media Statements URL
  • National Department of Health Data Dictionary URL
  • MedPagesURL
  • Statistics South AfricaURL



  • I want to help, but dont have an idea: You can take a look at the issues to see which one you might be interested in tackling.
  • I have an idea or new feature: Create a new issue first, assign it to yourself and then fork the repo.

Submitting Changes [Pull Request]



Citing the dataset

On a visualisation/notebook/webapp:

Data Science for Social Impact Research Group @ University of Pretoria, Coronavirus COVID-19 (2019-nCoV) Data Repository for South Africa. Available on:

In a publication

@dataset{marivate_vukosi_2020_3732419, author = {Marivate, Vukosi and de Waal, Alta and Combrink, Herkulaas and Lebogo, Ofentswe and Moodley, Shivan and Mtsweni, Nompumelelo and Rikhotso, Vuthlari and Welsh, Jay and Mkhondwane, S’busiso}, title = {{Coronavirus disease (COVID-19) case data - South Africa}}, month = mar, year = 2020, publisher = {Zenodo}, doi = {10.5281/zenodo.3732419}, url = {[} }


comments powered by Disqus