OPENAPI Detail

XML JSON

Ministry of Health and Welfare_Corona 19 Attempts

This service provides a query function for the status of COVID-19 outbreak by city/province, including the cumulative number of confirmed cases, daily increase or decrease in confirmed cases, cumulative number of releases from quarantine, number of quarantined patients, number of local outbreaks, and number of overseas inflows. * Based on 17 metropolitan areas (Seoul, Busan, Daegu, Incheon, Gwangju, Daejeon, Ulsan, Sejong, Gyeonggi, Gangwon, Chungbuk, Chungnam, Jeonbuk, Jeonnam, Gyeongbuk, Gyeongnam, Jeju) ※ Data source: Korea Disease Control and Prevention Agency (Coronavirus Disease-19 website) ※ We would like to inform you that as the Central Disaster and Safety Countermeasure Headquarters (Korea Disease Control and Prevention Agency) has upgraded the COVID-19 infectious disease status to Level 4, the update of the COVID-19 outbreak status data by city/province will be discontinued from September 1, 2023.

※ Application for use is only available on the PC version.

Ministry of Health and Welfare_Corona 19 Attempts Information such as classification and provision of file data information system
Classified Health - Health care Provided By
Department Department No
API Type REST Data Format JSON+XML
Usage 3333 Keyword Infectious diseases,covid-19,Current status,Ministry of Welfare,data,trial
Registered 2022-02-07 Edited 2025-06-13
Deliberation Type dev : disallow / run : allow
Payment free
Scope of License
References (복구중)_OpenAPI 활용가이드(코로나19_코로나19 시도 발생현황).hwp

Function

  • Application for Use Development level : Not allowed / Operation level : allowed
  • Available traffic 10000 / Operational account can increase traffic by applying for use case registration
  • Requested Link http://apis.data.go.kr/1352000/ODMS_COVID_04/callCovid04Api
  • Service URL http://apis.data.go.kr/1352000/ODMS_COVID_04

Request Parameter

Request Parameter

Category(Korean) Category(English) Size Division Sample Data Description
서비스키 serviceKey 100 Essential - Authentication key received from the public data portal
페이지 번호 pageNo 4 Essential 1 Page number
한 페이지 결과 수 numOfRows 4 Essential 500 Number of results per page
데이터유형 apiType 4 Optional xml Result format (xml/JSON)
기준일자 std_day 20 Optional 2021-12-15 Base date
시도명 gubun 100 Optional 경기 City name

Response Element

Response Element

Category(Korean) Category(English) Size Division Sample Data Description
결과코드 resultCode 2 Essential 00 Result code
결과메시지 resultMsg 50 Essential OK Result message
한 페이지 결과 수 numOfRows 4 Essential 500 Number of results per page
페이지 번호 pageNo 4 Essential 1 Page number
전체 결과 수 totalCount 4 Essential 15504 Total number of results
누적확진자수 defCnt 20 Essential 159481 Cumulative confirmed cases
시도명 gubun 100 Essential 경기 City name
시도명(중문) gubunCn 100 Optional 京畿 City name (Chinese)
시도명(영문) gubunEn 200 Optional Gyeonggi-do City name (English)
전일대비확진자증감수 incDec 10 Optional 2299 Number of confirmed cases increased compared to the previous day
누적격리해제수 isolClearCnt 20 Optional 132485 Cumulative number of quarantine releases
격리중환자수 isolIngCnt 20 Optional 0 Number of patients in isolation
발생건수 localOccCnt 20 Optional 2296 Local occurrence
해외유입수 overFlowCnt 20 Optional 3 Overseas inflow
10만명당발생율 qurRate 20 Optional 1188 Incidence rate per 100,000 people
기준일자 stdDay 20 Essential 2021-12-15 Base date

Sample Code

Please check the sample code on your PC.