본문 바로가기

전자공시스템 DART

로그인 마이페이지 공시업무 다트소개 오픈API RSS이용안내 사이트맵


오픈API

  • 오픈API 소개
  • 오픈API 개발가이드
  • 인증키 신청/관리
통합검색

오픈API 개발가이드

홈 > 오픈API 개발가이드

  • ㆍDART 공시 정보에 대한 검색 결과를 외부 개발자 및 사용자에게 XML 또는 JSON(P) 형식으로 제공하는 API 서비스입니다.
  • ㆍDART 오픈API를 이용해 DART의 공시 정보를 자사의 홈페이지나 앱에서 서비스할 수 있습니다.
  • ㆍDART 오픈API는 원활한 공시서비스를 위하여 일시적으로 제한될 수 있습니다.
  • ㆍ개발 관련 사항은 ☎ 02-3145-8627로 문의하시기 바랍니다.

검색 API

요청 주소

http://dart.fss.or.kr/api/search.xml?auth=xxx     xml 응답

http://dart.fss.or.kr/api/search.json?auth=xxx    json 응답

요청 변수

요청변수 목록
요청변수 설명
auth 발급받은 인증키(40자리)(필수)
crp_cd 공시대상회사의 종목코드(상장사:숫자 6자리) 또는 고유번호(기타법인:숫자 8자리)
end_dt 검색종료 접수일자(YYYYMMDD) : 없으면 당일
start_dt 검색시작 접수일자(YYYYMMDD) : 없으면 end_dt
crp_cd가 없는 경우 검색기간은 3개월로 제한
fin_rpt 최종보고서만 검색여부(Y or N) 기본값 : N
(정정이 있는 경우 최종정정만 검색)
dsp_tp 정기공시(A), 주요사항보고(B), 발행공시(C), 지분공시(D), 기타공시(E),
외부감사관련(F), 펀드공시(G), 자산유동화(H), 거래소공시(I), 공정위공시(J)
bsn_tp 정기공시(5), 주요사항보고(3), 발행공시(11), 지분공시(4), 기타공시(9),
외부감사관련(4), 펀드공시(3), 자산유동화(6), 거래소공시(6), 공정위공시(5)
(상세 유형 참조)
sort 접수일자(date), 회사명(crp), 보고서명(rpt) 기본값 : date
series 오름차순(asc), 내림차순(desc) 기본값 : desc
page_no 페이지 번호(1~n) 기본값 : 1
page_set 페이지당 건수(1~100) 기본값 : 10, 최대값 : 100
callback 콜백함수명(JSONP용)

상세 유형

응답 결과

응답 결과 목록
result list 설명
err_code 에러코드(오류 메시지 참조)
err_msg 에러메시지(오류 메시지 참조)
page_no 페이지 번호
page_set 페이지당 건수
total_count 총 건수
total_page 총 페이지 수
crp_cls 법인구분 : Y(유가), K(코스닥), N(코넥스), E(기타)
crp_nm 공시대상회사의 종목명(상장사) 또는 법인명(기타법인)
crp_cd 공시대상회사의 종목코드(6자리) 또는 고유번호(8자리)
rpt_nm 공시구분+보고서명+기타정보
[기재정정] : 본 보고서명으로 이미 제출된 보고서의 기재내용이 변경되어 제출된 것임
[첨부정정] : 본 보고서명으로 이미 제출된 보고서의 첨부내용이 변경되어 제출된 것임
[첨부추가] : 본 보고서명으로 이미 제출된 보고서의 첨부서류가 추가되어 제출된 것임
[변경등록] : 본 보고서명으로 이미 제출된 보고서의 유동화계획이 변경되어 제출된 것임
[연장결정] : 본 보고서명으로 이미 제출된 보고서의 신탁계약이 연장되어 제출된 것임
[발행조건확정] : 본 보고서명으로 이미 제출된 보고서의 유가증권 발행조건이 확정되어 제출된 것임
[정정명령부과] : 본 보고서에 대하여 금융감독원이 정정명령을 부과한 것임
[정정제출요구] : 본 보고서에 대하여 금융감독원이 정정제출요구을 부과한 것임
rcp_no 접수번호(공시뷰어 연결에 이용)
- PC용 : http://dart.fss.or.kr/dsaf001/main.do?rcpNo=접수번호
- 모바일용 : http://m.dart.fss.or.kr/html_mdart/MD1007.html?rcpNo=접수번호
flr_nm 공시 제출인명
rcp_dt 공시 접수일자(YYYYMMDD)
rmk 조합된 문자로 각각은 아래와 같은 의미가 있음
유 : 본 공시사항은 한국거래소 유가증권시장본부 소관임
코 : 본 공시사항은 한국거래소 코스닥시장본부 소관임
채 : 본 문서는 한국거래소 채권상장법인 공시사항임
넥 : 본 문서는 한국거래소 코넥스시장 소관임
공 : 본 공시사항은 공정거래위원회 소관임
연 : 본 보고서는 연결부분을 포함한 것임
정 : 본 보고서 제출 후 정정신고가 있으니 관련 보고서를 참조하시기 바람
철 : 본 보고서는 철회(간주)되었으니 관련 철회신고서(철회간주안내)를 참고하시기 바람

검색API 샘플

- 당일 접수 10건
http://dart.fss.or.kr/api/search.xml?auth=xxx
- 당일 접수 100건
http://dart.fss.or.kr/api/search.xml?auth=xxx&page_set=100
- 회사의 당일 접수 10건
http://dart.fss.or.kr/api/search.xml?auth=xxx&crp_cd=xxx
- 회사의 당일 접수 최종보고서만 10건
http://dart.fss.or.kr/api/search.xml?auth=xxx&crp_cd=xxx&fin_rpt=Y
- 회사의 전체(19990101~당일) 공시 10건
http://dart.fss.or.kr/api/search.xml?auth=xxx&crp_cd=xxx&start_dt=19990101
- 회사의 전체 정기공시 10건
http://dart.fss.or.kr/api/search.xml?auth=xxx&crp_cd=xxx&start_dt=19990101&dsp_tp=A
- 회사의 전체 사업+반기+분기보고서 10건
http://dart.fss.or.kr/api/search.xml?auth=xxx&crp_cd=xxx&start_dt=19990101&bsn_tp=A001&bsn_tp=A002&bsn_tp=A003

응답 방식

  • - 응답 인코딩 : UTF-8
  • - XML 방식 응답
  • - JSON 방식 응답
  • - JSONP 방식 출력 : 자바스크립트만으로 이용할 수 있도록 콜백(Callback)함수를 지원합니다.

오류 메시지

오류 메시지 목록
에러코드 에러메시지
000 정상
010 등록되지 않은 키입니다.
011 사용할 수 없는 키입니다. 오픈API에 등록되었으나, 일시적으로 사용 중지된 키를 통하여 검색하는 경우 발생합니다.
020 요청 제한을 초과하였습니다. 일반적으로는 10,000건 이상의 요청에 대하여 이 에러 메시지가 발생되나, 요청 제한이 다르게 설정된 경우에는 이에 준하여 발생됩니다.
100 필드의 부적절한 값입니다. 필드 설명에 없는 값을 사용한 경우에 발생하는 메시지입니다.
800 원활한 공시서비스를 위하여 오픈API 서비스가 중지 중입니다.
900 정의되지 않은 오류가 발생하였습니다.

실시간 데이터 확인

- 응답 방식 :       데이터보기

데이터보기 입력 항목
구 분

기업개황 API

요청 주소

http://dart.fss.or.kr/api/company.xml?auth=xxx&crp_cd=xxx    xml 응답

http://dart.fss.or.kr/api/company.json?auth=xxx&crp_cd=xxx   json 응답

요청 변수

요청변수 목록
요청변수 설명
auth 발급받은 인증키(40자리)(필수)
crp_cd 회사의 종목코드(상장사:숫자 6자리) 또는 고유번호(기타법인:숫자 8자리)(필수)
callback 콜백함수명(JSONP용)

응답 결과

응답결과 목록
result 설명
err_code 에러코드(오류 메시지 참조)
err_msg 에러메시지(오류 메시지 참조)
crp_nm 정식명칭
crp_nm_e 영문명칭
crp_nm_i 종목명(상장사) 또는 약식명칭(기타법인)
stock_cd 상장회사인 경우 주식의 종목코드
ceo_nm 대표자명
crp_cls 법인구분 : Y(유가), K(코스닥), N(코넥스), E(기타)
crp_no 법인등록번호
bsn_no 사업자등록번호
adr 주소
hm_url 홈페이지
ir_url IR홈페이지
phn_no 전화번호
fax_no 팩스번호
ind_cd 업종코드
est_dt 설립일(YYYYMMDD)
acc_mt 결산월(MM)

응답 방식

  • - 응답 인코딩 : UTF-8
  • - XML 방식 출력
  • - JSON 방식 출력
  • - JSONP 방식 출력 : 자바스크립트만으로 이용할 수 있도록 콜백(Callback)함수를 지원합니다.

오류 메시지

오류 메시지 목록
에러코드 에러메시지
000 정상
010 등록되지 않은 키입니다.
011 사용할 수 없는 키입니다. 오픈API에 등록되었으나, 일시적으로 사용 중지된 키를 통하여 검색하는 경우 발생합니다.
020 요청 제한을 초과하였습니다. 일반적으로는 10,000건 이상의 요청에 대하여 이 에러 메시지가 발생되나, 요청 제한이 다르게 설정된 경우에는 이에 준하여 발생됩니다.
100 필드의 부적절한 값입니다. 필드 설명에 없는 값을 사용한 경우에 발생하는 메시지입니다.
800 원활한 공시서비스를 위하여 오픈API 서비스가 중지 중입니다.
900 정의되지 않은 오류가 발생하였습니다.

실시간 데이터 확인

- 응답 방식 :       데이터보기

데이터보기 입력 항목
구 분

모바일전자공시 QR코드 (http://mdart.fss.or.kr 모바일 사이트로 이동)

이용자가이드