OpenDART(opendart.fss.or.kr/api/…)는 요청이 잘못됐거나 자료가 없으면 결과 대신
{"status":"…","message":"…"} 를 돌려줍니다. 정상은 000 입니다.
자주 만나는 코드와, 2026년 9월 17일에 실제로 받아 본 결과입니다.
| 코드 | 뜻 | 할 일 |
|---|---|---|
010 | 등록되지 않은 인증키 | 40자리를 다시 복사해 넣습니다. 앞뒤 빈칸이 섞이지 않았는지 봅니다 |
011 | 사용할 수 없는 인증키 | OpenDART 인증키 관리에서 키 상태를 확인합니다 |
013 | 조회된 자료가 없음 — 오류가 아닙니다 | 조건(기간 · 보고서 종류 · 회사)을 넓혀 봅니다 |
020 | 요청 한도 초과 | 회사·연도를 나눠 조회하거나 다음 날 다시 합니다 |
100 | 요청 값이 잘못됨 | 함께 온 message 에 어느 값이 문제인지 적혀 있습니다 |
010 — 인증키가 틀렸을 때
40자리 꼴만 맞춘 예시 키(0123456789abcdef…)로 공시검색 주소를 직접 불러 보았습니다.
{"status":"010","message":"등록되지 않은 인증키입니다."}키를 옮기다 한 글자가 빠지거나, 메일에서 복사할 때 줄바꿈·빈칸이 딸려 오면 이렇게 됩니다.
013 — 자료가 없을 때
공시 수집기에서 삼성전자(00126380)의 공시를 2026-01-01 ~ 2026-01-02 이틀로 검색했습니다. 그 사이에 올라온 공시가 없어 결과가 비었습니다.
2026.09.17 판부터는 요청 로그에도 · corp_code=00126380 → [013] 조회된 데이터가 없습니다 (오류 아님) 처럼 어느 조합이 비었는지 남습니다.
013 은 요청은 제대로 됐고 조건에 맞는 자료만 없다는 뜻입니다. 정기보고서 항목(배당 · 임원 현황 같은 것)은 그 해에 해당 보고서를 제출하지 않았으면 013 이 옵니다. 사업연도나 보고서 종류(1분기 · 반기 · 3분기 · 사업)를 바꿔 보세요.
100 — 값이 잘못됐을 때
대표적인 예가 공시검색의 기간 제한입니다. 고유번호 없이 긴 기간을 넣으면 100 과 함께 이유가 옵니다. 자세한 화면은 공시검색 기간이 3개월로 막힐 때에 있습니다.
020 — 한도를 넘었을 때
이번에는 재현하지 않았습니다(한도를 일부러 다 쓰면 그날 조회를 못 합니다). 회사와 연도를 아주 많이 걸어 한 번에 돌리면 닿을 수 있으므로, 나눠서 조회하는 편이 안전합니다.