{"id":16253181,"url":"https://github.com/simperfy/covid-19-api-philippines-doh","last_synced_at":"2026-03-04T15:31:43.523Z","repository":{"id":53083459,"uuid":"280135866","full_name":"Simperfy/Covid-19-API-Philippines-DOH","owner":"Simperfy","description":"💊 Unofficial Covid-19 Web API for Philippines from data collected by DOH using Node.js that updates itself as soon as DOH released new Data.","archived":false,"fork":false,"pushed_at":"2021-04-08T14:47:12.000Z","size":1826,"stargazers_count":31,"open_issues_count":3,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-08-20T06:47:37.807Z","etag":null,"topics":["covid","covid-19","covid-19-api","covid-api","covid19-philippines","doh-data-drop","mongodb","nodejs","philippines"],"latest_commit_sha":null,"homepage":"https://covid19-api-philippines.herokuapp.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Simperfy.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-07-16T11:27:01.000Z","updated_at":"2025-04-09T13:43:40.000Z","dependencies_parsed_at":"2022-09-12T11:13:51.304Z","dependency_job_id":null,"html_url":"https://github.com/Simperfy/Covid-19-API-Philippines-DOH","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Simperfy/Covid-19-API-Philippines-DOH","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simperfy%2FCovid-19-API-Philippines-DOH","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simperfy%2FCovid-19-API-Philippines-DOH/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simperfy%2FCovid-19-API-Philippines-DOH/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simperfy%2FCovid-19-API-Philippines-DOH/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Simperfy","download_url":"https://codeload.github.com/Simperfy/Covid-19-API-Philippines-DOH/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simperfy%2FCovid-19-API-Philippines-DOH/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30084963,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T13:22:36.021Z","status":"ssl_error","status_checked_at":"2026-03-04T13:20:45.750Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["covid","covid-19","covid-19-api","covid-api","covid19-philippines","doh-data-drop","mongodb","nodejs","philippines"],"created_at":"2024-10-10T15:16:15.187Z","updated_at":"2026-03-04T15:31:43.506Z","avatar_url":"https://github.com/Simperfy.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Covid-19-API-Philippines-DOH (Beta)\n\n![CodeFactor Grade](https://img.shields.io/codefactor/grade/github/Simperfy/Covid-19-API-Philippines-DOH?style=plastic)\n![GitHub Workflow Status](https://img.shields.io/github/workflow/status/Simperfy/Covid-19-API-Philippines-DOH/Node.js%20CI?style=plastic)\n![License](https://img.shields.io/github/license/simperfy/Covid-19-API-Philippines-DOH?style=plastic\u0026logo=github)\n![Last Commit](https://img.shields.io/github/last-commit/simperfy/Covid-19-API-Philippines-DOH?style=plastic\u0026logo=github)\n![Stars](https://img.shields.io/github/stars/simperfy/Covid-19-API-Philippines-DOH?style=plastic\u0026logo=github)\n![Forks](https://img.shields.io/github/forks/Simperfy/Covid-19-API-Philippines-DOH?style=plastic\u0026logo=github)\n![Tweet](https://img.shields.io/twitter/url?url=https%3A%2F%2Fgithub.com%2FSimperfy%2FCovid-19-API-Philippines-DOH)\n\n#### Covid-19 Web API for Philippines from data collected by DOH using Node.js that automatically updates itself.\n\u003e A Web API doesn't use web scraping to fetch data from DOH website instead it collects the data from the csv file from DOH Google Drive.\n\u003e This means that even if DOH website changes this API will be able to maintain itself.\n\n\u003cbr\u003e\n\n---\n\n\u003cbr\u003e\n\n## 📌 Endpoints\nBase URL \n\n(MAIN): https://covid19-api-philippines.herokuapp.com/\n\n(Optional) https://covid19-ph-api.herokuapp.com/ 🆕\n\n[Documentation in POSTMAN are available here](https://documenter.getpostman.com/view/12463261/T1LV9jLU?version=latest)\n\n\u003cbr\u003e\n\n**Get list of all possible values for the specified field 🆕**\n\n*datasets: `case_information`, `facilities_information`*\n\n*(DEFAULT: `case_information`)*\n```http\nGET api/list-of/:field\nGET api/list-of/:field?dataset=case_information\n\neg:\nGET api/list-of/regions\nGET api/list-of/age_groups\n```\n\n## Case Information\n\n\u003cdetails\u003e\n \u003csummary\u003e\u003cb\u003e\u003ci\u003eView Endpoints \u003c/i\u003e\u003c/b\u003e\u003c/summary\u003e\n\n\u003cbr\u003e\n\n**Fetching summary**\n```http\nGET api/summary\nGET api/summary?region={region}\n```\n\u003cdetails\u003e\n \u003csummary\u003e\u003ci\u003eExample Response\u003c/i\u003e\u003c/summary\u003e\n\n```JSON\n{\n \"data\": {\n \"total\": 89374,\n \"recoveries\": 65064,\n \"deaths\": 1983,\n \"active_cases\": 22327,\n \"fatality_rate\": \"2.22\",\n \"recovery_rate\": \"72.80\"\n }\n}\n```\n\n\u003c/details\u003e\n\n\u003cbr\u003e\n\n**Fetching Top Regions**\n```http\nGET api/top-regions\n```\n\n\u003cdetails\u003e\n \u003csummary\u003e\u003ci\u003eExample Response\u003c/i\u003e\u003c/summary\u003e\n\n```JSON\n{\n \"data\": [\n {\n \"region\": \"ncr\",\n \"cases\": 115906,\n \"recovered\": 75658,\n \"deaths\": 1553\n },\n {\n \"region\": \"region iv-a: calabarzon\",\n \"cases\": 30489,\n \"recovered\": 17281,\n \"deaths\": 282\n },\n {...},\n {\n \"region\": \"caraga\",\n \"cases\": 490,\n \"recovered\": 298,\n \"deaths\": 4\n }\n ]\n}\n```\n\n\u003c/details\u003e\n\n\u003cbr\u003e\n\n\n**Fetching No. of Cases Timeline**\n```http\nGET api/timeline\nGET api/timeline?region={region_name}\n```\n\n\u003cdetails\u003e\n \u003csummary\u003e\u003ci\u003eExample Response\u003c/i\u003e\u003c/summary\u003e\n\n```JSON\n{\n \"data\": [\n {\n \"cases\": 43,\n \"recovered\": 38,\n \"died\": 4,\n \"date\": \"2020-03-01\"\n },\n {\n \"cases\": 18,\n \"recovered\": 14,\n \"died\": 4,\n \"date\": \"2020-03-02\"\n },\n {...},\n {\n \"cases\": 2109,\n \"recovered\": 1992,\n \"died\": 12,\n \"date\": \"2020-07-17\"\n },\n ]\n}\n```\n\n\u003c/details\u003e\n\n\u003cbr\u003e\n\n---\n\n\u003cbr\u003e\n\n**Fetching raw data** (Ordered by case_code)\n*`limit` cannot exceed `10000`*\n```http\nGET api/get?page=1\u0026limit=10000\n```\n\n**Fetching raw data by month**\n```http\nGET api/get?month=03\n```\n\n**Fetching raw data by specific date**\n```http\nGET api/get?month=03\u0026date=01\n```\n\n**Fetching raw data with filters**\n\n```http\nGET api/get?region_res=ncr\u0026age_group=20-24\n```\n\u003cdetails\u003e\n \u003csummary\u003e\u003ci\u003eExample Response\u003c/i\u003e\u003c/summary\u003e\n\n ```JSON\n {\n \"data\": [\n {\n \"case_code\": \"C100018\",\n \"age\": 53,\n \"age_group\": \"50-54\",\n \"sex\": \"female\",\n \"date_specimen\": \"2020-04-30\",\n \"date_result_release\": \"2020-05-09\",\n \"date_rep_conf\": \"2020-05-11\",\n \"date_died\": \"\",\n \"date_recover\": \"\",\n \"removal_type\": \"recovered\",\n \"admitted\": \"no\",\n \"region_res\": \"Region IV-A: CALABARZON\",\n \"prov_res\": \"laguna\",\n \"city_mun_res\": \"city of san pedro\",\n \"city_muni_psgc\": \"PH043425000\",\n \"health_status\": \"recovered\",\n \"quarantined\": \"no\",\n \"date_onset\": \"\",\n \"pregnant_tab\": \"no\"\n },\n {...}\n ],\n \"pagination\": {\n \"next_page\": 2,\n \"limit\": 10000,\n \"max_page\": 10\n },\n \"result_count\": 10000\n }\n ```\n\n\u003c/details\u003e\n\n\u003cbr\u003e\n\n\u003c/details\u003e\n\n## Facilities Information \u003csup\u003e🆕\u003c/sup\u003e\n\n\u003cdetails\u003e\n \u003csummary\u003e\u003cb\u003e\u003ci\u003eView Endpoints \u003c/i\u003e\u003c/b\u003e\u003c/summary\u003e\n \n\u003cbr\u003e\n\n**Fetching facilities summary**\n```http\nGET api/facilities/summary\n```\n\n\u003cdetails\u003e\n \u003csummary\u003e\u003ci\u003eExample Response\u003c/i\u003e\u003c/summary\u003e\n\n```JSON\n{\n \"data\": {\n \"total_facilities\": 1912,\n \"occupancy_rate\": 0.49,\n \"beds\": {\n \"total_vacant\": 9945,\n \"total_occupied\": 9730,\n \"covid\": {\n \"icu_v\": 774,\n \"icu_o\": 831,\n \"isolbed_v\": 6638,\n \"isolbed_o\": 6240,\n \"beds_ward_v\": 2533,\n \"beds_ward_o\": 2659\n },\n \"non_covid\": {\n \"icu_v_nc\": 3345,\n \"icu_o_nc\": 2938,\n \"nonicu_v_nc\": 41335,\n \"nonicu_o_nc\": 42019\n }\n },\n \"equipments\": {\n \"mechvent_v\": 1537,\n \"mechvent_o\": 607,\n \"mechvent_v_nc\": 2399,\n \"mechvent_o_nc\": 2399\n }\n }\n}\n```\n\n\u003c/details\u003e\n\n\u003cbr\u003e\n\n**Fetching list of facilities**\n```http\nGET api/list-of/hospitals?dataset=facilities_information\n```\n\n\u003cdetails\u003e\n \u003csummary\u003e\u003ci\u003eExample Response\u003c/i\u003e\u003c/summary\u003e\n\n```JSON\n{\n \"data\": [\n {\n \"name\": \"a. de la cruz maternity hospital\"\n },\n {\n \"name\": \"a. zarate general hospital\"\n },\n {...},\n {\n \"name\": \"zone medical and intervention hospital, inc.\"\n }\n ]\n}\n```\n\n\u003c/details\u003e\n\n\u003cbr\u003e\n\n**Fetching raw facility/hospital records**\n\n```http\nGET api/facilities\nGET api/facilities?region={region name}\nGET api/facilities?hospital_name={hospital name}\n```\n\n\u003cdetails\u003e\n \u003csummary\u003e\u003ci\u003eExample Response\u003c/i\u003e\u003c/summary\u003e\n\n```JSON\n{\n \"data\": [\n {\n \"hfhudcode\": \"DOH000000000000410\",\n \"cf_name\": \"asian hospital inc.\",\n \"updated_date\": \"2020-08-13T16:05:30.000Z\",\n \"added_date\": \"2020-08-13T16:05:30.000Z\",\n \"report_date\": \"2020-08-13T00:00:00.000Z\",\n \"icu_v\": 0,\n \"icu_o\": 16,\n \"isolbed_v\": 0,\n \"isolbed_o\": 69,\n \"beds_ward_v\": 0,\n \"beds_ward_o\": 0,\n \"mechvent_v\": 18,\n \"mechvent_o\": 28,\n \"icu_v_nc\": 10,\n \"icu_o_nc\": 14,\n \"nonicu_v_nc\": 72,\n \"nonicu_o_nc\": 55,\n \"mechvent_v_nc\": 18,\n \"mechvent_o_nc\": 28,\n \"q_nurse\": 37,\n \"q_doctor\": 7,\n \"q_other\": 68,\n \"nurse_adm\": 0,\n \"doctor_adm\": 1,\n \"other_adm\": 2,\n \"susp_asym\": 0,\n \"susp_mild\": 18,\n \"susp_severe\": 1,\n \"susp_crit\": 1,\n \"susp_died\": 0,\n \"prob_asym\": 0,\n \"prob_mild\": 1,\n \"prob_severe\": 0,\n \"prob_crit\": 0,\n \"prob_died\": 0,\n \"conf_asym\": 0,\n \"conf_mild\": 50,\n \"conf_severe\": 0,\n \"conf_crit\": 15,\n \"conf_died\": 1,\n \"t_patient_adm\": 2,\n \"t_patient_er\": 2,\n \"t_patient_icu\": 2,\n \"trans_ttmf\": 2,\n \"discharged\": 2,\n \"region\": \"national capital region (ncr)\",\n \"region_psgc\": \"PH130000000\",\n \"province\": \"ncr, fourth district (not a province)\",\n \"province_psgc\": \"PH137600000\",\n \"city_mun\": \"city of muntinlupa\",\n \"city_mun_psgc\": \"PH137603000\",\n \"north_coord\": \"0.0\",\n \"east_coord\": \"0.0\"\n },\n {...}\n ]\n}\n```\n\n\u003c/details\u003e\n\n\u003cbr\u003e\n\n\u003c/details\u003e\n\n\u003cbr\u003e\n\n---\n\n\u003cbr\u003e\n\n## Field and Values Reference\n\n| Field | Type | Values | Can be empty? |\n|---------------------|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| case_code | String(7) | UNIQUE ID String with length of 7 | NO |\n| age | Integer(3) | 1 - 3 digits | NO |\n| age_group | String | 0-4, 5-9, 10-14, 15-19, 20-24, 25-29, 30-34, 35-39, 40-44, 45-49, 50-54, 55-59, 60-64, 65-69, 70-74, 75-79, 80+ | YES |\n| sex | String | male, female | NO |\n| date_specimen | Date(YYYY-MM-DD) | Date(YYYY-MM-DD) | YES |\n| date_result_release | Date(YYYY-MM-DD) | Date(YYYY-MM-DD) | YES |\n| date_rep_conf | Date(YYYY-MM-DD) | Date(YYYY-MM-DD) | NO |\n| date_died | Date(YYYY-MM-DD) | Date(YYYY-MM-DD) | YES |\n| date_recover | Date(YYYY-MM-DD) | Date(YYYY-MM-DD) | YES |\n| removal_type | String | recovered, died | YES |\n| admitted | String | yes, no | YES |\n| region_res/region | String | BARMM, CAR, CARAGA, NCR, Region I: Ilocos Region, Region II: Cagayan Valley, Region III: Central Luzon, Region IV-A: CALABARZON, Region IV-B: MIMAROPA, Region IX: Zamboanga Peninsula, Region V: Bicol Region, Region VI: Western Visayas, Region VII: Central Visayas, Region VIII: Eastern Visayas, Region X: Northern Mindanao, Region XI: Davao Region, Region XII: SOCCSKSARGEN, REPATRIATE | YES |\n| prov_res | String | abra, agusan del norte, agusan del sur, aklan, albay, antique, apayao, aurora, basilan, bataan, batangas, benguet, biliran, bohol, bukidnon, bulacan, cagayan, camarines norte, camarines sur, camiguin, capiz, catanduanes, cavite, cebu, city of isabela (not a province), cotabato (north cotabato) cotabato city (not a province), davao de oro, davao del norte, davao del sur, davao occidental, davao oriental, eastern samar, guimaras, ifugao, ilocos norte, ilocos sur, iloilo, isabela, kalinga, la union, laguna, lanao del norte, lanao del sur, leyte, maguindanao, marinduque, masbate, misamis occidental, misamis oriental, mountain province, ncr, negros occidental, negros oriental, northern samar, nueva ecija, nueva vizcaya, occidental mindoro, oriental mindoro, palawan, pampanga, pangasinan, quezon, rizal, romblon, samar (western samar), sarangani, siquijor, sorsogon, south cotabato, southern leyte, sultan kudarat, sulu, surigao del norte, surigao del sur, tarlac, tawi-tawi, zambales, zamboanga del norte, zamboanga del sur, zamboanga sibugay, | YES |\n| city_mun_res | String | https://pastebin.com/EmP2MQDH | YES |\n| city_muni_psgc | String | Unique ID (eg: PH012802000) | YES |\n| health_status | String | asymptomatic, critical, died, mild, recovered, severe | NO |\n| quarantined | String | yes, no | YES |\n| date_onset | Date(YYYY-MM-DD) | Date(YYYY-MM-DD) | YES |\n| pregnant_tab | String | yes, no | YES |\n\u003cbr\u003e\n\n\n---\n\n\u003cbr\u003e\n\n## 🔨 Installation\n\n### Prerequisites\n* [configured service account](https://developers.google.com/identity/protocols/oauth2/service-account)\n* [Node.js](https://nodejs.org/en/)\n* [MongoDB](https://www.mongodb.com/)\n\n### Steps\n\n1. run the command:\n\n```\n$ npm install\n```\n\n2. Create a [Service Account](https://developers.google.com/identity/protocols/oauth2/service-account) and download the key.\n\n3. copy .env.example to .env and paste the service key and database credentials respectively\n\n4. Run the project in development:\n\n```\n$ npm run dev\n```\n\n5. Done\n\nNOTE: You use `/api/updatedatabase` to manually update database (in development mode)\n\n\u003cbr\u003e\n\nAPI documentation:\n\n[Documentation in POSTMAN are available here](https://documenter.getpostman.com/view/12463261/T1LV9jLU?version=latest)\n\n\u003cbr\u003e\n\n---\n\n\u003cbr\u003e\n\n## 📄 About the Data\n### Where does the data come from?\n\n* The data comes from [DOH DATA DROP](http://bit.ly/DataDropPH) and [DOH DATA DROP Archives](https://drive.google.com/drive/folders/1UelgRGmUGNMKH1Q3nzqTj57V41bjmnxg)\n* The data wasn't tampered and was directly converted to json from csv without heavy modification.\n\n\u003cbr\u003e\n\n\n## 🔧 Built With\n* [Node.js](https://nodejs.org) - open source server environment.\n* [ExpressJS](http://www.dropwizard.io/1.0.2/docs/) - The web framework used\n* [Google Drive API v3](https://developers.google.com/drive/api/v3/about-sdk) - Used to download files from DOH\n* [Amazon Web Services](https://aws.amazon.com/) - Provides MySQL in Deployment\n\n\u003cbr\u003e\n\n## Authors\n\n* 🐶 **Simperfy** - [Github](https://github.com/Simperfy)\n\n\u003cbr\u003e\n\n## Acknowledgments\n\n* 💗 [DOH - Philippines](https://www.doh.gov.ph/) - Data Source\n\n\u003cbr\u003e\n\n## Donate\n\n- ETH: 0x38f0278bB385ce5cce627C8E8085AbA774761169\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimperfy%2Fcovid-19-api-philippines-doh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimperfy%2Fcovid-19-api-philippines-doh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimperfy%2Fcovid-19-api-philippines-doh/lists"}