Service
금융감독원 OpenDART(opendart.fss.or.kr) 기업 정보: corp_code(고유번호)로 기업의 공식 DART 기업개황을 조회하고, 고유번호 일괄 아카이브를 바탕으로 회사명 또는 KRX 종목코드에서 corp_code를 찾습니다.
99.95%30일 가동률평균 응답219ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-corporate-info/company-profile | Retrieves a company's official DART corporate profile by its OpenDART corp_code: corp_name, ceo_nm, stock_code, established_date, market_segment, and jurir_no. Use when you already have a corp_code (from korea-corporate-info:corporate-codes or a prior DART lookup). Do NOT use to search by company name or stock ticker — use korea-corporate-info:corporate-codes first to resolve corp_code. Returns null for any nullable field OpenDART left blank; throws NO_DATA if OpenDART has no record for the given corp_code. The retired 1.x fields est_dt (compact YYYYMMDD) and corp_cls (DART's raw market letter) are still returned beside their replacements until 2026-10-12. | |
| POST | /v1/korea-corporate-info/corporate-codes | Searches the cached OpenDART corp-code catalog by company-name substring (query, at least two characters) or exact six-digit stock_code; one of the two is required. Use when you need a corp_code from a company name or KRX stock ticker. Do NOT use to fetch company details — pass the returned corp_code to korea-corporate-info:company-profile instead. Returns companies (at most 50 rows per page, default 20), total_count, and has_more; never returns the full bulk archive. | |
| POST | /v1/korea-corporate-info/dividends | Returns dividend metrics disclosed in a company's periodic report, one row per metric and stock class (for example per-share cash dividend and payout ratio) with current-term, previous-term, and two-terms-prior values. Use when you have corp_code, bsns_year, and report_type; resolve corp_code first via korea-corporate-info:corporate-codes if you only know the company name. Do NOT use for share counts or executives — use korea-corporate-info:stock-summary or korea-corporate-info:executives instead. Returns an array of rows with category, stock_kind, current_term, previous_term, and two_terms_prior. | |
| POST | /v1/korea-corporate-info/executives | Lists executives disclosed in a company's periodic report: name, gender, birth month, position, registered-director status, employment type, responsibilities, tenure period, and term end date. Use when you have corp_code, bsns_year, and report_type; resolve corp_code first via korea-corporate-info:corporate-codes if you only know the company name. Do NOT use for dividends or share counts — use korea-corporate-info:dividends or korea-corporate-info:stock-summary instead. Returns one row per executive. The retired 1.x fields birth_year_month, full_time, and tenure_end_date (the report's own Korean wording) are still returned beside their replacements until 2026-10-12. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| POST | /v1/korea-corporate-info/search-disclosures | Searches OpenDART filing receipts by company (corp_code) and/or receipt-date range (begin_date, end_date as YYYY-MM-DD), paged with page and limit; every filter is optional, so a date-only search covers all companies. Use when you need the disclosures one company filed or all filings in a period. Do NOT use to look up a company's profile or to resolve corp_code — use korea-corporate-info:company-profile or korea-corporate-info:corporate-codes instead. Returns page, limit, total_count, total_page, and list rows with receipt_no, corp_code, corp_name, report_name, filer_name, filed_on, and remarks; if OpenDART reports no matching filing (status 013), throws NO_DATA. The retired 1.x names page_no and page_count (on input and output) and receipt_date are still accepted and returned until 2026-10-12. |
| POST | /v1/korea-corporate-info/stock-summary | Returns share totals from a company's periodic report, one row per stock category: authorized, cumulative issued, cumulative reduced, outstanding, treasury, and circulating shares. Use when you have corp_code, bsns_year, and report_type; resolve corp_code first via korea-corporate-info:corporate-codes if you only know the company name. Do NOT use for dividends or executives — use korea-corporate-info:dividends or korea-corporate-info:executives instead. Returns an array of rows with category, authorized_shares, shares_issued_to_date, shares_reduced_to_date, shares_outstanding, treasury_shares, and shares_in_circulation. |
