본문 바로가기

전자공시스템 DART

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


오픈API

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

오픈API 개발가이드

홈 > 오픈API 개발가이드

  • ㆍDART 공시 정보에 대한 검색 결과를 외부 개발자 및 사용자에게 XML 또는 JSON(P) 형식으로 제공하는 API 서비스입니다.
  • ㆍDART 오픈API를 이용해 DART의 공시 정보를 자사의 홈페이지나 앱에서 서비스할 수 있습니다.
  • ㆍ개발 관련 사항은 ☎ 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),
외부감사관련(3), 펀드공시(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 필드의 부적절한 값입니다. 필드 설명에 없는 값을 사용한 경우에 발생하는 메시지입니다.
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 필드의 부적절한 값입니다. 필드 설명에 없는 값을 사용한 경우에 발생하는 메시지입니다.
900 정의되지 않은 오류가 발생하였습니다.

실시간 데이터 확인

- 응답 방식 :       데이터보기

데이터보기 입력 항목
구 분

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

이용자가이드