사업보고서 주요정보

자기주식 취득 및 처분 현황 개발가이드

기본 정보
기본 정보
GET https://opendart.fss.or.kr/api/tesstkAcqsDspsSttus.json UTF-8 JSON
GET https://opendart.fss.or.kr/api/tesstkAcqsDspsSttus.xml UTF-8 XML
요청 인자
요청 인자
요청키 명칭 타입 필수여부 값설명
crtfc_key API 인증키 STRING(40) Y 발급받은 인증키(40자리)
corp_code 고유번호 STRING(8) Y 공시대상회사의 고유번호(8자리)
※ 개발가이드 > 공시정보 > 고유번호 참고
bsns_year 사업연도 STRING(4) Y 사업연도(4자리) ※ 2015년 이후 부터 정보제공
reprt_code 보고서 코드 STRING(5) Y 1분기보고서 : 11013
반기보고서 : 11012
3분기보고서 : 11014
사업보고서 : 11011
응답 결과
응답 결과
result
status 에러 및 정보 코드 (※메시지 설명 참조)
message 에러 및 정보 메시지 (※메시지 설명 참조)
list
rcept_no 접수번호 접수번호(14자리)

※ 공시뷰어 연결에 이용예시
- PC용 : https://dart.fss.or.kr/dsaf001/main.do?rcpNo=접수번호
corp_cls 법인구분 법인구분 : Y(유가), K(코스닥), N(코넥스), E(기타)
corp_code 고유번호 공시대상회사의 고유번호(8자리)
corp_name 법인명 법인명
acqs_mth1 취득방법 대분류 배당가능이익범위 이내 취득, 기타취득, 총계 등
acqs_mth2 취득방법 중분류 직접취득, 신탁계약에 의한취득, 기타취득, 총계 등
acqs_mth3 취득방법 소분류 장내직접취득, 장외직접취득, 공개매수, 주식매수청구권행사, 수탁자보유물량, 현물보유량, 기타취득, 소계, 총계 등
stock_knd 주식 종류 보통주, 우선주 등
bsis_qy 기초 수량 9,999,999,999
change_qy_acqs 변동 수량 취득 9,999,999,999
change_qy_dsps 변동 수량 처분 9,999,999,999
change_qy_incnr 변동 수량 소각 9,999,999,999
trmend_qy 기말 수량 9,999,999,999
rm 비고 비고
OpenAPI 테스트
OpenAPI 서비스의 요청인자에 값을 입력하고 검색버튼을 클릭하여 해당 서비스의 선택하신 응답을 확인해 볼 수 있습니다.
OpenAPI 테스트
API 인증키* xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx   고유번호* 00126380   사업연도* 2018   보고서 코드* 11011  
메시지 설명
메시지 설명
- 000 : 정상
- 010 : 등록되지 않은 키입니다.
- 011 : 사용할 수 없는 키입니다. 오픈API에 등록되었으나, 일시적으로 사용 중지된 키를 통하여 검색하는 경우 발생합니다.
- 012 : 접근할 수 없는 IP입니다.
- 013 : 조회된 데이타가 없습니다.
- 014 : 파일이 존재하지 않습니다.
- 020 : 요청 제한을 초과하였습니다.
일반적으로는 20,000건 이상의 요청에 대하여 이 에러 메시지가 발생되나, 요청 제한이 다르게 설정된 경우에는 이에 준하여 발생됩니다.
- 021 : 조회 가능한 회사 개수가 초과하였습니다.(최대 100건)
- 100 : 필드의 부적절한 값입니다. 필드 설명에 없는 값을 사용한 경우에 발생하는 메시지입니다.
- 101 : 부적절한 접근입니다.
- 800 : 시스템 점검으로 인한 서비스가 중지 중입니다.
- 900 : 정의되지 않은 오류가 발생하였습니다.
- 901 : 사용자 계정의 개인정보 보유기간이 만료되어 사용할 수 없는 키입니다. 관리자 이메일(opendart@fss.or.kr)로 문의하시기 바랍니다.