상장기업 재무정보

재무제표 원본파일(XBRL) 개발가이드

기본 정보
기본 정보
GET https://opendart.fss.or.kr/api/fnlttXbrl.xml UTF-8 Zip FILE (binary)
요청 인자
요청 인자
요청키 명칭 타입 필수여부 값설명
crtfc_key API 인증키 STRING(40) Y 발급받은 인증키(40자리)
rcept_no 접수번호 STRING(8) Y 접수번호 ※ 조회방법 : 공시검색API 호출 > 응답요청 값 rcept_no 추출
reprt_code 보고서 코드 STRING(5) Y 1분기보고서 : 11013
반기보고서 : 11012
3분기보고서 : 11014
사업보고서 : 11011
응답 결과
응답 결과
result
status 에러 및 정보 코드 (※메시지 설명 참조)
message 에러 및 정보 메시지 (※메시지 설명 참조)
OpenAPI 테스트
출력포멧이 Zip FILE (binary)인 경우 브라우저 테스트를 제공하지 않습니다. ※ chrome, edge는 브라우저 특성상 zip파일이 아닌 xml파일로 다운로드 되므로, 확장자명을 zip으로 바꾸시면 정상적으로 확인하실 수 있습니다.
OpenAPI 테스트
Zip FILE (binary)
API 인증키* xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx   접수번호* 20190401004781   보고서 코드* 11011  
메시지 설명
메시지 설명
- 000 : 정상
- 010 : 등록되지 않은 키입니다.
- 011 : 사용할 수 없는 키입니다. 오픈API에 등록되었으나, 일시적으로 사용 중지된 키를 통하여 검색하는 경우 발생합니다.
- 012 : 접근할 수 없는 IP입니다.
- 013 : 조회된 데이타가 없습니다.
- 014 : 파일이 존재하지 않습니다.
- 020 : 요청 제한을 초과하였습니다.
일반적으로는 20,000건 이상의 요청에 대하여 이 에러 메시지가 발생되나, 요청 제한이 다르게 설정된 경우에는 이에 준하여 발생됩니다.
- 021 : 조회 가능한 회사 개수가 초과하였습니다.(최대 100건)
- 100 : 필드의 부적절한 값입니다. 필드 설명에 없는 값을 사용한 경우에 발생하는 메시지입니다.
- 101 : 부적절한 접근입니다.
- 800 : 시스템 점검으로 인한 서비스가 중지 중입니다.
- 900 : 정의되지 않은 오류가 발생하였습니다.
- 901 : 사용자 계정의 개인정보 보유기간이 만료되어 사용할 수 없는 키입니다. 관리자 이메일(opendart@fss.or.kr)로 문의하시기 바랍니다.