Guide for Developers to Major financial indicators of a single company
GET | https://engopendart.fss.or.kr/engapi/fnlttSinglIndx.json | UTF-8 | JSON |
GET | https://engopendart.fss.or.kr/engapi/fnlttSinglIndx.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) | Y | Corporation code of disclosing company (8 digits) ※ See: Guide for Developers > Disclosure Information > Corporation Code |
bsns_year | Fiscal year | STRING(4) | Y | Fiscal year (4 digits) ※ Information provided since 2022 |
reprt_code | Report code | STRING(5) | Y | First Quarterly Report : 11013 Semi-annual Report : 11012 Third Quarterly Report : 11014 Annual Report : 11011 |
idx_cl_code | Indicator category code | STRING(7) | Y | Profitability indicator : M210000 Stability indicator : M220000 Growth indicator : M230000 Activity indicator : M240000 |
result | ||
status | Error and information code | (※ See message description) |
message | Error and information message | (※ See message description) |
list | ||
reprt_code | Report code | First Quarterly Report : 11013 Semi-annual Report : 11012 Third Quarterly Report : 11014 Annual Report : 11011 |
bsns_year | Fiscal year | 2020 |
corp_code | Corporation code | Corporation code of disclosing company (8 digits) |
stock_code | Item code | Listed corporation’s item code (6 digits) |
stlm_dt | Settlement date | YYYY.MM.DD |
idx_cl_code | Indicator category code | Profitability indicator : M210000 Stability indicator : M220000 Growth indicator : M230000 Activity indicator : M240000 |
idx_cl_nm | Indicator category name | Profitability indicator, Stability indicator, Growth indicator, Activity indicator |
idx_code | Indicator code | e.g. M211000 |
idx_nm | Indicator name | e.g. Operating income margin |
idx_val | Indicator value | e.g. 0.256 |
- 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). |