Skip to content
Go to file


Failed to load latest commit information.
Latest commit message
Commit time

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

DOI dsJournal

Coronavirus COVID-19 (2019-nCoV) Data Repository 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]


dataset url raw_url[file]
provincial_cumulative_timeline_confirmed provincial_cumulative_timeline_confirmed provincial_cumulative_timeline_confirmed.csv
provincial_cumulative_timeline_recoveries provincial_cumulative_timeline_recoveries provincial_cumulative_timeline_recoveries.csv
provincial_cumulative_timeline_testing provincial_cumulative_timeline_testing provincial_cumulative_timeline_testing.csv
provincial_cumulative_timeline_deaths provincial_cumulative_timeline_deaths provincial_cumulative_timeline_deaths.csv
death_statistics covid19za_timeline_death_statistics covid19za_timeline_death_statistics.csv
transmission_type covid19za_timeline_transmission_type covid19za_timeline_transmission_type.csv
testing covid19za_timeline_testing covid19za_timeline_testing.csv
district_data district_data
DoH PDFs and Extracted CSVs doh_pdf
DoH Whatsapp case update archive doh_whatsapp
health facility data [public and private] health_system_za_hospitals_v1 health_system_za_hospitals_v1.csv
nicd_daily_national_report nicd_daily_national_report nicd_daily_national_report.csv
nicd_hospital_surveillance_data nicd_hospital_surveillance_data nicd_hospital_surveillance_data.csv
samrc_excess_deaths_province samrc_excess_deaths_province samrc_excess_deaths_province.csv


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 individual cases up to 25 March, use the confirmed_cases.

dataset url raw_url[file]
confirmed_cases* [updated to 25 March] covid19za_timeline_confirmed covid19za_timeline_confirmed.csv
deaths covid19za_timeline_deaths covid19za_timeline_deaths.csv

* NICD no longer gives individual case data. Please use provincial_cumulative_timeline from 26 March onwards.


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
  • MedPages URL
  • Statistics South Africa URL



  • I want to help, but don't 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.

Adopting a file

Once you have chosen how you are going to contribute, you must list which files you will be working on by adding your name to the adopt-a-file csv file. Edit covid19za_volunteer_adopted_file.

Submitting Changes [Pull Request]

Resources [Get some ideas]


Contributors Made with contributors-img.


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

Data Science Journal

@article{marivate2020use, Author = {Vukosi Marivate and Herkulaas MvE Combrink}, Journal = {Data Science Journal}, Number = {1}, Pages = {1-7}, Title = {Use of Available Data To Inform The COVID-19 Outbreak in South Africa: A Case Study.}, Volume = {19}, Year = {2020}, url = {} }

and Dataset

@dataset{marivate_vukosi_2020_3819126, author = {Marivate, Vukosi and Arbi, Riaz and Combrink, Herkulaas and de Waal, Alta and Dryza, Henkho and Egersdorfer, Derrick and Garnett, Shaun and Gordon, Brent and Greyling, Lizel and Lebogo, Ofentswe and Mackie, Dave and Merry, Bruce and Mkhondwane, S'busiso and Mokoatle, Mpho and Moodley, Shivan and Mtsweni, Jabu and Mtsweni, Nompumelelo and Myburgh, Paul and Richter, Jannik and Rikhotso, Vuthlari and Rosen, Simon and Sefara, Joseph and van der Walt, Anelda and van Heerden, Schalk and Welsh, Jay and Hazelhurst, Scott and Petersen, Chad and Mbuvha, Rendani and Dhlamini, Nelisiwe and James, Vaibhavi}, title = {{Coronavirus disease (COVID-19) case data - South Africa}}, month = mar, year = 2020, publisher = {Zenodo}, doi = {10.5281/zenodo.3819126}, url = {} }


Some of COVID-19 Data for South Africa (data in this repo) is currently being used by other independent projects shown in the table below :

Project Name Project Description Project Demo Project owner Country
1. Covid-19 SA Data Data visualizations corresponding to the current Covid-19 outbreak in South Africa [Website],[GitHub Repo] Simon Rosen South Africa
2. Covid-19 testing areas A Covid-19 Testing Facilities Map [Website],[GitHub Repo] Yannick Zehnder Switzerland
3. Covid-19 Map A Coronavirus Map [Website] [GitHub Repo] Jay Welsh South Africa
4. Covid-19 Telegram Bot Corona virus statistics via Telegram Link CodeChap South Africa
5. Covid-19 Xitsonga Dashboard Xitsonga Dashboard Link South Africa
6. Hospitals' capacity to respond to Covid-19 Data visualization mapping local hospitals (private ad public) in South Africa [Map Viz] ,[Repo] Nompumelelo South Africa
7. Covid-19 Trends Covid-19 analytics dashboard for South Africa [Website] [Repo] Schalk van Heerden South Africa
8. Covid-19 Tshivenda Dashboard Tshivenda Dashboard Link South Africa
9. Map of Health facilites around me Map showing comparable details of hospitals around my location in response to Covid-19 [Webpage] , [GitHub Repo] These authors South Africa
10. R-based Interactive health facilties Map Afrimapr, mapping health facilities using R-building blocks [Webpage] [Repo] Dr Andy South United Kingdom
11. Estimating the Reproductive Number of COVID-19 Estimating effective reproductive number for SA, it's provinces and other countries. [Website] Louis Rossouw South Africa
12. Modelling COVID-19 in South Africa at a Provincial Level Modelling COVID-19 in South Africa at a Provincial Level using reported and excess deaths. [Website] Louis Rossouw South Africa


We want to acknowledge support from these organisations

You can’t perform that action at this time.