Guide for Developers to Search disclosures
GET | https://engopendart.fss.or.kr/engapi/list.json | UTF-8 | JSON |
GET | https://engopendart.fss.or.kr/engapi/list.xml | UTF-8 | XML |
Requested key | Name | Type | Whether required | Value description |
---|---|---|---|---|
crtfc_key | API authentication key | STRING(40) | Y | Issued authentication key (40 digits) |
corp_code | Corporation code | STRING(8) | N | Corporation code of disclosing company (8 digits) ※ See: Guide for Developers > Disclosure Information > Corporation code |
bgn_de | Start date | STRING(8) | N | Filing date when search starts (YYYYMMDD) 1) Default value: End date (end_de) 2) If no corporation code (corp_code), search period is limited to three months. |
end_de | End date | STRING(8) | N | Filing date when search ends (YYYYMMDD) 1) Default value: Day of search |
last_reprt_at | Whether to search final reports | STRING(1) | N | Whether to search only final reports (Y or N) 1) Default: N (if there are any corrections, search only the final correction) |
pblntf_ty | Type of disclosure | STRING(1) | N | A: Periodic Disclosure B: Report on Major Issues C: Issuance Disclosure D: Equity Disclosure E: Other Disclosure F: Related to External Audits G: Fund Disclosure H: Asset-Backed Securitization I: Exchange Disclosure J: Fair Trade Commission Disclosure |
pblntf_detail_ty | Detailed disclosure type | STRING(4) | N | (※ See detailed types: pblntf_detail_ty) |
corp_cls | Corporation type | STRING(1) | N | Corporation type: Y (KOSPI), K (KOSDAQ), N (KONEX), E (Other) ※ View all if no type, cannot enter multiple filters |
sort | Sorting | STRING(4) | N | Filing date: date Company name: crp Report name: rpt ※ Default value: date |
sort_mth | Sorting filter | STRING(4) | N | Ascending (asc), descending(desc) ※ Default value: desc |
page_no | Page No. | STRING(5) | N | Page No. (1~n) default value: 1 |
page_count | Results per page | STRING(3) | N | Results per page (1~100) Default value: 10, Max value: 100 |
A | A001 | Annual Report |
A002 | Semi-annual Report | |
A003 | Quarterly Report | |
A004 | Financial Report of Registered Corporation (Pre-Capital Markets Act) | |
A005 | Financial Report of Small-Scale Public Offering Corporation | |
B | B001 | Report on Major Issues |
B002 | Report on Material Business Matters (Pre-Capital Markets Act) | |
B003 | Report on Transactions with Largest Shareholder, etc. (Pre-Capital Markets Act) | |
C | C001 | Securities Report (Equity Securities) |
C002 | Securities Report (Debt Securities) | |
C003 | Securities Report (Derivative-Linked Securities) | |
C004 | Securities Report (Merger, etc.) | |
C005 | Securities Report (Other) | |
C006 | Small-Scale Public Offering (Equity Securities) | |
C007 | Small-Scale Public Offering (Debt Securities) | |
C008 | Small-Scale Public Offering (Derivative-Linked Securities) | |
C009 | Small-Scale Public Offering (Merger, etc.) | |
C010 | Small-Scale Public Offering (Other) | |
C011 | Small-Scale Over-the-Counter Sales | |
D | D001 | Report on Significant Holdings of Stocks, etc. |
D002 | Report on Specific Securities Owned by Executives and Major Shareholders | |
D003 | Proxy Solicitation | |
D004 | Tender Offer | |
D005 | Report on trading plans of executives and major shareholders for specific securities | |
E | E001 | Acquisition/Disposal of Treasury Stock |
E002 | Entering/Termination of Trust Contracts | |
E003 | Report on Conclusion of Merger, etc. | |
E004 | Report on Granting Stock Options | |
E005 | Report on Outside Directors | |
E006 | Report on Calling Shareholders' Meeting | |
E007 | Market Making / Stabilizing Operation | |
E008 | Report of Merger, etc. (Pre-Capital Markets Act) | |
E009 | FSC Registration / Cancellation (Pre-Capital Markets Act) | |
E010 | Covered Bonds Issuance Plan | |
F | F001 | Audit Report |
F002 | Consolidated Audit Report | |
F003 | Combined Audit Report | |
F004 | Accounting Firm Annual Report | |
F005 | Report on Non-submission of Financial Statements before Audit | |
G | G001 | Securities Report (Collective Investment Securities – Trust Type) |
G002 | Securities Report (Collective Investment Securities – Corporate Type) | |
G003 | Securities Report (Collective Investment Securities – Merger) | |
H | H001 | Asset Securitization Plan / Transfer Registration |
H002 | Annual/ Semi-annual / Quarterly Reports | |
H003 | Securities Report (Asset-Backed Securities, etc.) | |
H004 | Claim-Backed Securitization Plan / Transfer Registration | |
H005 | Report on Material Matters Related to Asset Securitization | |
H006 | Report on Major Issues | |
I | I001 | Ad Hoc Disclosure |
I002 | Fair Disclosure | |
I003 | Market Measures / Guide | |
I004 | Equity Disclosure | |
I005 | Securities Investment Company | |
I006 | Bond Disclosure | |
J | J001 | Related to Large-Scale Internal Transaction |
J002 | Related to Large-Scale Internal Transaction (Former) | |
J004 | Business Group Status Disclosure | |
J005 | Disclosure of Material Facts Related to the Unlisted Company | |
J006 | Other Fair Trade Commission Disclosures | |
J008 | Related to Large-Scale Internal Transaction (for Nonprofits) | |
J009 | Disclosure of Subcontracting Payment Terms |
result | ||
status | Error and information code | (※ See message description) |
message | Error and information message | (※ See message description) |
page_no | Page No. | Page No. |
page_count | Results per page | Results per page |
total_count | Total results | Total results |
total_page | Total pages | Total pages |
list | ||
corp_cls | Corporation type | Corporation type: Y (KOSPI), K (KOSDAQ), N (KONEX), E (Other) |
corp_name | Item name (corporation name) | The item name (listed company) or corporation name (other corporation) of the corporation subject to disclosure |
corp_code | Corporation code | Corporation code of the corporation subject to disclosure (8 digits) |
stock_code | Item code | Listed corporation’s item code (6 digits) |
report_nm | Report title | Disclosure type + report name + other information [Revision of statements]: A report previously submitted under this title was corrected in its descriptions and re-submitted. [Corrected attachment]: A report previously submitted under this title was re-submitted when the substance of at least one attachment was modified. [Added attachment]: A report previously submitted under this title was re-submitted when one or more attachment was added. [Modified registration]: A report previously submitted under this title was re-submitted when its asset securitization was modified. [Decision to extend]: A report previously submitted under this title was re-submitted since the trust contract was extended. [Conditions for issuance finalized]: A report previously submitted under this title was re-submitted upon the finalization of the conditions for issuing marketable securities. [Correction order imposed]: The Financial Supervisory Service issued a correction order on this report. [Requested submission of correction]: The Financial Supervisory Service imposed a request for a correction on this report. |
rcept_no | Filing No. | Filing No. (14 digits) ※ Example link to Disclosure Viewer - For PCs: https://englishdart.fss.or.kr/dsbh001/main.do?rcpNo=FilingNumber |
flr_nm | Disclosure submitter name | Disclosure submitter name |
rcept_dt | Filing date | Disclosure filing date (YYYYMMDD) |
rm | Note | The individual letters in the combinations have the following meanings: S: This disclosure is under the authority of the KOSPI Market Division of the Korea Exchange. K: This disclosure is under the authority of the KOSDAQ Market Division of the Korea Exchange. B: This document is a disclosure item of a bonds listed company of the Korea Exchange. N: This document is under the authority of the KONEX Market of the Korea Exchange. F: This disclosure is under the authority of the Fair Trade Commission. C: This report includes consolidated portions. U: A correction report was made after the submission of this report; see the relevant report. W: This report was (deemed) withdrawn; see the relevant withdrawal statement (notice of deemed withdrawal). |
- 000 : | Normal |
---|---|
- 010 : | This is not a registered key. |
- 011 : | This key cannot be used. This error occurs when a search is made through a key that is registered to Open API but temporarily suspended. |
- 012 : | This IP is not available. |
- 013 : | No data viewed. |
- 014 : | The file does not exist. |
- 020 : | Call limit exceeded. Although this error message is usually generated in response to at least 20,000 requests, it may occur at different thresholds if the rate limit is configured otherwise. |
- 021 : | You exceeded the number of companies viewable at a time (up to 100). |
- 100 : | The value does not comply with the field. This message is generated when a value not included in the field description is entered. |
- 101 : | Inappropriate access. |
- 800 : | The service is suspended for maintenance. |
- 900 : | An undefined error has occurred. |
- 901 : | This key is unusable because the personal information retention period for the user account has expired. Please inquire at the admin email (opendart@fss.or.kr). |