정기보고서 재무정보

단일회사 주요 재무지표 개발가이드

기본 정보
기본 정보
GET https://opendart.fss.or.kr/api/fnlttSinglIndx.json UTF-8 JSON
GET https://opendart.fss.or.kr/api/fnlttSinglIndx.xml UTF-8 XML
요청 인자
요청 인자
요청키 명칭 타입 필수여부 값설명
crtfc_key API 인증키 STRING(40) Y 발급받은 인증키(40자리)
corp_code 고유번호 STRING(8) Y 공시대상회사의 고유번호(8자리)
※ 개발가이드 > 공시정보 > 고유번호 참고
bsns_year 사업연도 STRING(4) Y 사업연도(4자리)
※ 2023년 3분기 이후 부터 정보제공
reprt_code 보고서 코드 STRING(5) Y 1분기보고서 : 11013
반기보고서 : 11012
3분기보고서 : 11014
사업보고서 : 11011
idx_cl_code 지표분류코드 STRING(7) Y 수익성지표 : M210000 안정성지표 : M220000 성장성지표 : M230000 활동성지표 : M240000
응답 결과
응답 결과
result
status 에러 및 정보 코드 (※메시지 설명 참조)
message 에러 및 정보 메시지 (※메시지 설명 참조)
list
bsns_year 사업 연도 2023
corp_code 고유번호 공시대상회사의 고유번호(8자리)
stock_code 종목 코드 상장회사의 종목코드(6자리)
reprt_code 보고서 코드 1분기보고서 : 11013
반기보고서 : 11012
3분기보고서 : 11014
사업보고서 : 11011
idx_cl_code 지표분류코드 수익성지표 : M210000 안정성지표 : M220000 성장성지표 : M230000 활동성지표 : M240000
idx_cl_nm 지표분류명 수익성지표,안정성지표,성장성지표,활동성지표
idx_code 지표코드 ex) M211000
idx_nm 지표명 ex) 영업이익률
idx_val 지표값 ex) 0.256
OpenAPI 테스트
OpenAPI 서비스의 요청인자에 값을 입력하고 검색버튼을 클릭하여 해당 서비스의 선택하신 응답을 확인해 볼 수 있습니다.
OpenAPI 테스트
API 인증키* xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx   고유번호* 00164742   사업연도* 2023   보고서 코드* 11014   지표분류코드* M210000  
메시지 설명
메시지 설명
- 000 : 정상
- 010 : 등록되지 않은 키입니다.
- 011 : 사용할 수 없는 키입니다. 오픈API에 등록되었으나, 일시적으로 사용 중지된 키를 통하여 검색하는 경우 발생합니다.
- 012 : 접근할 수 없는 IP입니다.
- 013 : 조회된 데이타가 없습니다.
- 014 : 파일이 존재하지 않습니다.
- 020 : 요청 제한을 초과하였습니다.
일반적으로는 20,000건 이상의 요청에 대하여 이 에러 메시지가 발생되나, 요청 제한이 다르게 설정된 경우에는 이에 준하여 발생됩니다.
- 021 : 조회 가능한 회사 개수가 초과하였습니다.(최대 100건)
- 100 : 필드의 부적절한 값입니다. 필드 설명에 없는 값을 사용한 경우에 발생하는 메시지입니다.
- 101 : 부적절한 접근입니다.
- 800 : 시스템 점검으로 인한 서비스가 중지 중입니다.
- 900 : 정의되지 않은 오류가 발생하였습니다.
- 901 : 사용자 계정의 개인정보 보유기간이 만료되어 사용할 수 없는 키입니다. 관리자 이메일(opendart@fss.or.kr)로 문의하시기 바랍니다.