지분공시 종합정보

대량보유 상황보고 개발가이드

기본 정보
기본 정보
GET https://opendart.fss.or.kr/api/majorstock.json UTF-8 JSON
GET https://opendart.fss.or.kr/api/majorstock.xml UTF-8 XML
요청 인자
요청 인자
요청키 명칭 타입 필수여부 값설명
crtfc_key API 인증키 STRING(40) Y 발급받은 인증키(40자리)
corp_code 고유번호 STRING(8) Y 공시대상회사의 고유번호(8자리)
※ 개발가이드 > 공시정보 > 고유번호 참고
응답 결과
응답 결과
result
status 에러 및 정보 코드 (※메시지 설명 참조)
message 에러 및 정보 메시지 (※메시지 설명 참조)
list
rcept_no 접수번호 접수번호(14자리)

※ 공시뷰어 연결에 이용예시
- PC용 : https://dart.fss.or.kr/dsaf001/main.do?rcpNo=접수번호
rcept_dt 접수일자 공시 접수일자(YYYYMMDD)
corp_code 고유번호 공시대상회사의 고유번호(8자리)
corp_name 회사명 공시대상회사의 종목명(상장사) 또는 법인명(기타법인)
report_tp 보고구분 주식등의 대량보유상황 보고구분
repror 대표보고자 대표보고자
stkqy 보유주식등의 수 보유주식등의 수
stkqy_irds 보유주식등의 증감 보유주식등의 증감
stkrt 보유비율 보유비율
stkrt_irds 보유비율 증감 보유비율 증감
ctr_stkqy 주요체결 주식등의 수 주요체결 주식등의 수
ctr_stkrt 주요체결 보유비율 주요체결 보유비율
report_resn 보고사유 보고사유
OpenAPI 테스트
OpenAPI 서비스의 요청인자에 값을 입력하고 검색버튼을 클릭하여 해당 서비스의 선택하신 응답을 확인해 볼 수 있습니다.
OpenAPI 테스트
API 인증키* xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx   고유번호* 00126380  
메시지 설명
메시지 설명
- 000 : 정상
- 010 : 등록되지 않은 키입니다.
- 011 : 사용할 수 없는 키입니다. 오픈API에 등록되었으나, 일시적으로 사용 중지된 키를 통하여 검색하는 경우 발생합니다.
- 012 : 접근할 수 없는 IP입니다.
- 013 : 조회된 데이타가 없습니다.
- 014 : 파일이 존재하지 않습니다.
- 020 : 요청 제한을 초과하였습니다.
일반적으로는 20,000건 이상의 요청에 대하여 이 에러 메시지가 발생되나, 요청 제한이 다르게 설정된 경우에는 이에 준하여 발생됩니다.
- 021 : 조회 가능한 회사 개수가 초과하였습니다.(최대 100건)
- 100 : 필드의 부적절한 값입니다. 필드 설명에 없는 값을 사용한 경우에 발생하는 메시지입니다.
- 101 : 부적절한 접근입니다.
- 800 : 시스템 점검으로 인한 서비스가 중지 중입니다.
- 900 : 정의되지 않은 오류가 발생하였습니다.
- 901 : 사용자 계정의 개인정보 보유기간이 만료되어 사용할 수 없는 키입니다. 관리자 이메일(opendart@fss.or.kr)로 문의하시기 바랍니다.