Financial Information from Periodic Reports

Guide for Developers to XBRL taxonomy financial statements format

Basic information
Basic information
GET https://engopendart.fss.or.kr/engapi/xbrlTaxonomy.json UTF-8 JSON
GET https://engopendart.fss.or.kr/engapi/xbrlTaxonomy.xml UTF-8 XML
Requested variables
Requested key
Requested key Name Type Whether required Value description
crtfc_key API authentication key STRING(40) Y Issued authentication key (40 digits)
sj_div Type of financial statement STRING(5) Y (※ See Type of financial statement)
Type of financial statement
Type of financial statement
BS1 Statement of Financial Position Consolidated Current/Non-current Method
BS2 Statement of Financial Position Separate Current/Non-current Method
BS3 Statement of Financial Position Consolidated Liquidity Order Method
BS4 Statement of Financial Position Separate Liquidity Order Method
IS1 Separate Income Statement Consolidated Classification by Function
IS2 Separate Income Statement Separate Classification by Function
IS3 Separate Income Statement Consolidated Classification by Nature
IS4 Separate Income Statement Separate Classification by Nature
CIS1 Statement of comprehensive income Consolidated Post-Tax
CIS2 Statement of comprehensive income Separate Post-Tax
CIS3 Statement of comprehensive income Consolidated Pre-Tax
CIS4 Statement of comprehensive income Separate Pre-Tax
DCIS1 Single Statement of Comprehensive Income Consolidated Classification by Function Post-Tax Comprehensive Income
DCIS2 Single Statement of Comprehensive Income Separate Classification by Function Post-Tax Comprehensive Income
DCIS3 Single Statement of Comprehensive Income Consolidated Classification by Function Pre-Tax
DCIS4 Single Statement of Comprehensive Income Separate Classification by Function Pre-Tax
DCIS5 Single Statement of Comprehensive Income Consolidated Classification by Nature Post-Tax Comprehensive Income
DCIS6 Single Statement of Comprehensive Income Separate Classification by Nature Post-Tax Comprehensive Income
DCIS7 Single Statement of Comprehensive Income Consolidated Classification by Nature Pre-Tax
DCIS8 Single Statement of Comprehensive Income Separate Classification by Nature Pre-Tax
CF1 Statement of cash flows Consolidated Direct Method
CF2 Statement of cash flows Separate Direct Method
CF3 Statement of cash flows Consolidated Indirect Method
CF4 Statement of cash flows Separate Indirect Method
SCE1 Statement of Changes in Equity Consolidated
SCE2 Statement of Changes in Equity Separate
Response result
Response result
result
status Error and information code (※ See message description)
message Error and information message (※ See message description)
list
sj_div Type of financial statement Type of financial statement
account_id Account ID Unique account name
account_nm Account name Account name
bsns_de Baseline date Application baseline date
label_kor Korean output name Korean output name
label_eng English output name English output name
data_tp Data type ※ Data type description
- text block: Title
- Text : Text
- yyyy-mm-dd : Date
- X : Monetary Value
- (X): Negative Monetary Value
- X.XX : Decimalized Value
- Shares: Number of shares
- For each: When a disclosed item is repeatedly disclosed before and after.
- Blank: No input required
ifrs_ref IFRS Reference IFRS Reference

※ Output Example
K-IFRS 1001 Paragraph 54 (8),
K-IFRS 1001 Paragraph 78 (2)
OpenAPI Test
You can check your selected response to a given service by entering the value in the requested variable of the OpenAPI service and clicking “Search".
OpenAPI Test
API authentication key* xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Type of financial statement* BS1
Message description
Message description
- 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).