Guide for Developers to Overview of corporate status
GET | https://engopendart.fss.or.kr/engapi/company.json | UTF-8 | JSON |
GET | https://engopendart.fss.or.kr/engapi/company.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 |
result | Response variable | Response variable |
status | Error and information code | (※ See message description) |
message | Error and information message | (※ See message description) |
corp_name | Formal name | Formal corporate name |
corp_name_eng | English name | English formal corporate name |
stock_name | Item name (listed corporation) or abbreviated name (other corporation) | Item name (listed corporation) or abbreviated name (other corporation) |
stock_code | If a listed corporation, stock item code | Listed corporation’s item code (6 digits) |
ceo_nm | Representative name | Representative name |
corp_cls | Corporation type | Corporation type: Y (KOSPI), K (KOSDAQ), N (KONEX), E (Other) |
jurir_no | Corporate registration No. | Corporate registration No. |
bizr_no | Business registration No. | Business registration No. |
adres | Address | Address |
hm_url | Website URL | Website URL |
ir_url | IR website | IR website |
phn_no | Telephone No. | Telephone No. |
fax_no | Fax No. | Fax No. |
induty_code | Industry code | Industry code |
est_dt | Establishment date (YYYYMMDD) | Establishment date (YYYYMMDD) |
acc_mt | Month of settlement (MM) | Month of settlement (MM) |
- 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). |