moh-covid19-api

Because speedrunning code writing is fun™. And it took longer than what I thought it would take to finish it. Oops.

Jokes aside, this project provides Ministry of Health Malaysia COVID-19 statistics and COVID-19 Immunisation Task Force (CITF) public vaccination data in API form.

Alpha-version of the API is available at http://moh-covid19-api.chong601.cloud/api/alpha/ui.

Latest version of API on master is 0.3-alpha.

Latest version of API on http://moh-covid19-api.chong601.cloud/api/alpha/ui is 0.2-alpha.

Things to work on

• [phase 2 in-progress] Better database model (the source data makes it difficult to build one)
• [in progress] Complete the initial REST API implementation
• Make CSV data import less cancerous (it's pretty cancerific) Done
• Code cleanups
• Make PR to official Ministry of Health Malaysia COVID-19 repository and official CITF National Covid-​19 Immunisation Programme repository to promote this project!

Data set compatibility

This API is compatible with all COVID-19 data from 2021-08-11 onwards.

Available APIs

Epidemic data

Name	Description	URL endpoint	Status
cases_malaysia	Country-wide new cases data	/epidemic/cases_malaysia /epidemic/cases_malaysia/{date}	Done
cases_state	Per-state new cases data	/epidemic/cases_state /epidemic/cases_state/{state} /epidemic/cases_state/{state}/{date}	Done
clusters	All cluster data	/epidemic/clusters /epidemic/clusters /epidemic/clusters/category /epidemic/clusters/category/{category} /epidemic/clusters/state /epidemic/clusters/state/{state} /epidemic/clusters/status /epidemic/clusters/status/{status} /epidemic/clusters/{name}	Done
deaths_malaysia	Country-wide new deaths data	/epidemic/deaths_malaysia /epidemic/deaths_malaysia/{date}	Done
deaths_state	Per-state new deaths data	/epidemic/deaths_state /epidemic/deaths_state/{state} /epidemic/deaths_state/{state}/{date}	Done
hospital	Per-state hospital data	/epidemic/hospital /epidemic/hospital/{state} /epidemic/hospital/{state}/{date}	Done
icu	Per-state ICU data	/epidemic/icu /epidemic/icu/{state} /epidemic/icu/{state}/{date}	Done
pkrc	Per-state PKRC data	/epidemic/pkrc /epidemic/pkrc/{state} /epidemic/pkrc/{state}/{date}	Done
tests_malaysia	Country-wide COVID-19 testing data	/epidemic/tests_malaysia /epidemic/tests_malaysia/{date}	Done
linelist_deaths	Country-wide detailed deaths	/epidemic/linelist_deaths /epidemic/linelist_deaths/partial /epidemic/linelist_deaths/full	In progress

MySejahtera data

Name	Description	URL endpoint	Status
checkin_malaysia_time	MySejahtera check-in by time data	/mysejahtera/checkin_malaysia_time /mysejahtera/checkin_malaysia_time/{date}	Done
checkin_malaysia	Country-wide MySejahtera check-in data	/mysejahtera/checkin_malaysia /mysejahtera/checkin_malaysia{date}	Done
checkin_state	Per-state MySejahtera check-in data	/mysejahtera/checkin_state /mysejahtera/checkin_state/{state} /mysejahtera/checkin_state/{state}/{date}	Done
trace_malaysia	Contact tracing and HIDE system data	/mysejahtera/trace_malaysia /mysejahtera/trace_malaysia/{date}	Done

Static data

Name	Description	URL endpoint	Status
population	Population data	/static/population /static/population/{state}	Done

Vaccination registration data

Name	Description	URL endpoint	Status
vaxreg_malaysia	Country-wide vaccination registration data	/registration/vaxreg_malaysia /registration/vaxreg_malaysia/{date}	Done
vaxreg_state	Per-state vaccination registration data	/registration/vaxreg_state /registration/vaxreg_state/{state} /registration/vaxreg_state/{state}/{date}	Done

Vaccination data

Name	Description	URL endpoint	Status
vax_malaysia	Country-wide vaccination data	/vaccination/vax_malaysia /vaccination/vax_malaysia/{date}	Done
vax_state	Per-state vaccination data	/vaccination/vax_state /vaccination/vax_state/{state} /vaccination/vax_state/{state}/{date}	Done

Features

• Pandemic data
  • Country-wide case count
  • Per-state case count
  • Cluster details
  • Country-wide deaths
  • Per-state deaths
  • Per-state hospital statistics
  • Per-state ICU statistics
  • Per-state PKRC statistics
  • COVID-19 testing
  • Line-list deaths
• MySejahtera data
  • Check-ins by time
  • Country-wide check-ins
  • Per-state check-ins
  • Contact tracing and HIDE hotspot
• Population data
• [NEW] Vaccination data
  • [NEW] Country-wide vaccine registration statistics
  • [NEW] Per-state vaccine registration statistics
  • [NEW] Country-wide vaccination statistics
  • [NEW] Per-state vaccination statistics

And now, a message from the author...

This project intends to be the base on running RESTful API service on cloud and is currently hosted on OVHcloud.

API servers are available at:

• Beauharnois, Canada (active)
• Frankfurt, Germany (in progress)
• Singapore (in progress)

DB servers are located at

• Singapore (active)
• Frankfurt, Germany (in progress)

This project do cost money; somewhere approximately $25/month excluding development instances running for tests (which would be closer to $35/month).

If you utilize this API and do benefit from it (in some way), consider supporting me at Buy me a Coffee. This would help me develop more projects in the future!

For those that supported my project, many thanks in advance!