Skip to content
COVID 19 Data and Dashboard for South Africa
Jupyter Notebook Other
Branch: master
Clone or download

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


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

Data Available [/data]

dataset url raw_url[file]
confirmed_cases covid19za_timeline_confirmed covid19za_timeline_confirmed.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_3723347, author = {Marivate, Vukosi and de Waal, Alta and Combrink, Herkulaas and Lebogo, Ofentswe and Moodley, Shivan and Mtsweni, Nompumelelo and Rikhotso, Vuthlari}, title = {{Coronavirus disease (COVID-19) case data - South Africa}}, month = mar, year = 2020, publisher = {Zenodo}, doi = {10.5281/zenodo.3723347}, url = {} }


You can’t perform that action at this time.