National Election Commission_Voter Information
※ Application for use is only available on the PC version.
| 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 | ||
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
| 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) |
Please check the sample code on your PC.
| 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 | |
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
| 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) |
Please check the sample code on your PC.