OpenDART API: 한국 회사 정보를 고유번호로 조회

금융감독원 전자공시시스템 OpenDART에 공시하는 회사의 기업 정보를 다른 국가와 같은 형식으로 받습니다. 아래에 호출 방법, 응답 필드, 그리고 OpenDART에 없는 정보가 있습니다.

한국에 대해 API가 돌려주는 정보

Prometiam은 각국 공식 기업 정보를 하나의 형식으로 돌려주는 유료 REST API입니다. 한국은 country=KR과 함께 고유번호(8자리) 또는 사업자등록번호, 회사명을 보내면 됩니다. 응답에는 회사명, 고유번호, 사업자등록번호, 법인등록번호, 법인 형태, 설립일, 주소, 업종 코드(KSIC)가 들어 있습니다. 다른 국가와 같은 회사 객체이며, 등록처가 공개하지 않는 값은 null입니다.

필드의미
company_name, company_number회사명(한글)과 OpenDART 고유번호(8자리, 앞의 0 포함). 영문 회사명은 registry_details에 있습니다
legal_form법인 형태: 주식회사, 유한회사, 유한책임회사, 합자회사, 합명회사
business_registration_number, corporate_registration_number사업자등록번호(10자리)와 법인등록번호(13자리). business_number=로 사업자등록번호를 검색할 수 있습니다
status항상 unknown: OpenDART는 상태를 공개하지 않습니다
founding_date, address, city설립일과 주소(시·도는 registry_details.region)
activity_code한국표준산업분류(KSIC) 코드, 2~5자리
registry_details영문명, 상장 회사의 종목코드와 시장(KOSPI, KOSDAQ, KONEX), 결산월

고유번호

OpenDART 고유번호는 금융감독원이 공시 회사마다 부여하는 8자리 번호로, 앞자리의 0도 번호의 일부입니다(삼성전자는 00126380). 검증 숫자는 없어 형식만 확인합니다. 짧은 숫자는 앞의 0을 채워 읽고, 9자리 이상은 거절합니다. 10자리 사업자등록번호나 13자리 법인등록번호가 고유번호로 읽히지 않게 하기 위해서입니다. 형식이 틀린 값은 400(validation_error)을 돌려줍니다.

호출

curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=KR&company_number=00126380' \
  -H 'Authorization: Bearer rk_live_...'

응답은 data 목록이며 각 항목의 id로 GET /companies/{id}를 호출하면 전체 기록을 받습니다. 사업자등록번호로는 business_number=124-81-00998처럼 검색합니다.

등록 정보 변경 이벤트

한국에는 등록 정보 변경 이벤트(회사명, 법인 형태, 주소)가 있습니다. 변경이 데이터에 처음 나타난 날짜로 기록되며, 한국의 첫 적재 이전 이벤트는 없습니다. 상태는 항상 unknown이므로 상태 변경 이벤트는 없습니다. 목록은 영업일마다 갱신됩니다.

API가 한국에 대해 돌려주지 않는 정보

  • 공시 대상 회사만: DART에 공시하는 회사 가운데 상법상 회사 형태(주식회사, 유한회사, 유한책임회사, 합자회사, 합명회사)를 가진 회사만 제공합니다. 한국의 모든 회사는 아닙니다. 특별법에 따라 설립된 법인과 은행, 공공기관, 재단, 협회, 펀드와 투자 목적 회사, 외국 발행사, 개인은 제공하지 않습니다.
  • 상태: OpenDART는 회사의 상태를 공개하지 않으므로 모든 회사의 status는 unknown입니다(active가 아닙니다). 폐업일이나 해산일도 없습니다. 공시를 중단한 회사도 목록에 남습니다.
  • 임원, 주주, 자본금, 종업원 수: OpenDART의 회사 정보에는 없습니다. 대표자 이름도 읽지 않습니다. 임원이나 주주 조회는 제공하지 않습니다.
  • 부가가치세 번호: 제공하지 않습니다. vat 검색은 거절되고 vat_number는 null입니다.
  • 재무제표: API로 제공하지 않습니다.
  • 도산 공고: 한국은 도산 공고 대상 시장이 아닙니다.
  • 업종 코드: 한국표준산업분류(KSIC, KR-KSIC)이며 NACE가 아닙니다. 그래서 NACE, ISIC, NAICS 필드는 없습니다.
  • 모니터링: 한국 회사의 모니터링은 제공하지 않습니다.

출처: 금융감독원(FSS) 전자공시시스템 OpenDART, 「공공데이터의 제공 및 이용 활성화에 관한 법률」에 따른 공공데이터. Prometiam이 가공함. 금융감독원이 제공한 공식 자료가 아님. (Contains data from the Financial Supervisory Service (FSS) of the Republic of Korea, OpenDART electronic disclosure system (https://opendart.fss.or.kr), public data under the Act on Promotion of the Provision and Use of Public Data. Adapted by Prometiam; not an official FSS extract.)

Prometiam이 제공하는 것

하나의 키와 같은 호출로 서비스 중인 모든 국가를 조회합니다. 요금은 공개되어 있습니다: Starter 월 9.99유로(1,000 크레딧), Professional 29.99유로(10,000), Scale 99.99유로(50,000), Enterprise는 협의. 회사 검색과 기록 조회는 1 크레딧이며 오류는 무료입니다.

영어 버전: South Korea company data API.

관련 페이지

14일 무료 체험 시작 · API 문서

무료 체험은 14일이며 500 크레딧이 포함됩니다. 결제 카드가 필요하고 체험 기간에는 청구되지 않으며, 취소하지 않으면 Starter 요금제(월 9.99유로)로 이어집니다.