OPENAPI Detail

XML JSON

National Election Commission_Voter Information

Voter count information is provided by city, province, county, town, township, and district. ※ Required input items 1. Number of voters by electoral district: Enter election ID and election type code 2. Number of voters by town/village/dong: Enter election ID, city/province name, and district/city/county name 3. Number of voters by voting district: Enter election ID, city/province name, and district/city/county name 4. Number of voters by district/city/county: Enter election ID and city/province name 5. Number of voters by city/province: Enter election ID ※ Things to check · The district/city/county name (wiwName) and electoral district name (sggName) fields are provided when the election division code (sgTypecode) is 2: National Assembly member election, 4: district/city/county mayor election, 5: city/provincial council member election, 6: district/city/county council member election, and 10: education council member election. · The district/city/county head (wiwCount) field is provided when the election division code (sgTypecode) is 3: city/provincial governor election, and 11: education superintendent election.

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

National Election Commission_Voter Information Information such as classification and provision of file data information system
Classified General Public Administration - State administration Provided By
Department Department No
API Type REST Data Format JSON+XML
Usage 231 Keyword electoral votes,Voters by city and province,Voters by city and county,Voters by constituency,Voters by town, township, and district,Voters by voting district,Status of electoral votes,Number of votes
Registered 2021-11-19 Edited 2025-09-03
Deliberation Type dev : allow / run : disallow
Payment free
Scope of License
References OpenAPI활용가이드(선거인수현황정보)_v3.11.zip

Function

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

Request Parameter

Request Parameter

Category(Korean) Category(English) Size Division Sample Data Description
서비스키 serviceKey 255 Essential - Authentication key received from the public data portal
페이지 번호 pageNo 100 Optional 1 Page number
한 페이지 결과 수 numOfRows 100 Optional 10 Number of results per page
데이터포맷 resultType 4 Optional xml xml/json(default : xml)
선거ID sgId 10 Essential 20231011 Election ID
선거종류코드 sgTypecode 2 Essential 4 Election type code (only 2, 3, 4, 5, 6, 10, and 11 can be searched)
시도명 sdName 40 Optional 서울특별시 City/Province Name (Required only if the election type is not a city/provincial gubernatorial election or a superintendent of education election)
구시군명 wiwName 40 Optional City/county name (searchable if election type is city/provincial council election or district/city/county council election)

Response Element

Response Element

Category(Korean) Category(English) Size Division Sample Data Description
결과코드 resultCode 2 Essential 00 Result code (00: success)
결과메시지 resultMsg 50 Essential NORMAL SERVICE Result message
한 페이지 결과 수 numOfRows 4 Essential 10 Number of results per page
페이지 번호 pageNo 4 Essential 1 Page number
전체 결과 수 totalCount 4 Essential 3 Total number of results
결과순서 num 8 Essential 2 Result order
선거ID sgId 10 Essential 20231011 Election ID
시도명 sdName 40 Essential 서울특별시 City name
구시군명 wiwName 40 Optional 합계 City/county name (required only when the election type is not a city/provincial gubernatorial election or a superintendent of education election)
선거구명 sggName 40 Optional 중구 Constituency name (required only if the election type is not a city/provincial gubernatorial election or a superintendent of education election)
구시군수 wiwCount 4 Optional 25 Mayor of a city or county (required if the election type is a city/provincial governor election or a superintendent of education election)
읍면동수 emdCount 5 Optional 17 Township/village number
투표구수 tpgCount 6 Optional 43 Number of voting districts
인구수 ppltCnt 10 Essential 151296 Population (as of the date of compilation of the electoral roll)
인구수(재외국민) ntabPpltCnt 10 Optional 891 Population (overseas Koreans)
인구수(외국인) frgnrPpltCnt 10 Optional 0 Population (foreigners)
확정선거인수(계) cfmtnElcnt 10 Essential 134516 Confirmed number of voters (total)
확정선거인수(계_재외국민) cfmtnRacnt 10 Optional 778 Confirmed number of voters (total_overseas Koreans)
확정선거인수(계_외국인) cfmtnFrgnrCnt 10 Optional 0 Confirmed number of voters (total_foreigners)
확정선거인수(남) cfmtnManElcnt 10 Optional 65194 Confirmed number of voters (male)
확정선거인수(남_재외국민) cfmtnManRacnt 10 Optional 327 Confirmed number of voters (male, overseas Koreans)
확정선거인수(남_외국인) cfmtnManFrgnrCnt 10 Optional 0 Confirmed number of voters (male, foreigner)
확정선거인수(여) cfmtnFmlElcnt 10 Optional 69322 Confirmed number of voters (female)
확정선거인수(여_재외국민) cfmtnFmlRacnt 10 Optional 451 Confirmed number of voters (female_overseas Koreans)
확정선거인수(여_외국인) cfmtnFmlFrgnrCnt 10 Optional 0 Confirmed number of voters (female, foreign)
거소투표 신고인명부 등재자수(계) cfmtnRdvtDccnt 10 Essential 247 Number of voters registered on the absentee ballot list (including absentee voters)
거소투표 신고인명부 등재자수(계_재외국민) cfmtnNtabRdvtDccnt 10 Optional 0 Number of absentee voters registered on the absentee voting list
거소투표 신고인명부 등재자수(남) cfmtnRdvtManDccnt 10 Optional 205 Number of registered voters (male)
거소투표 신고인명부 등재자수(남_재외국민) cfmtnNtabRdvtManDccnt 10 Optional 0 Number of people registered on the absentee voting register (male, overseas Koreans)
거소투표 신고인명부 등재자수(여) cfmtnRdvtFmlDccnt 10 Optional 42 Number of registered voters (female)
거소투표 신고인명부 등재자수(여_재외국민) cfmtnNtabRdvtFmlDccnt 10 Optional 0 Number of registered voters (female, overseas Koreans)

Sample Code

Please check the sample code on your PC.