Korean Company Filings & Financials (DART) — English

Korean Company Filings & Financials (DART) — English

Korea's corporate disclosure system, DART (run by the Financial Supervisory Service), holds filings and audited financial statements for every listed company and every company subject to external audit — roughly 100,000 entities. It is free and official, but it is Korean-only: field names, account names, report titles and error codes are all in Korean, company lookups need an internal 8-digit code, and financial statements come back as strings with thousands separators.

This Actor turns that into clean JSON an analyst, a data pipeline or an AI agent can use directly: English-labeled fields, K-IFRS account names translated (with the Korean original kept alongside), amounts parsed to numbers, tickers and English company names resolved for you, and a link to the original filing on every record. No API key is needed for standard runs; pay only for the records you receive.

What you can pull

• Company profiles — legal name (KO/EN), ticker, market (KOSPI/KOSDAQ/KONEX), CEO, registration numbers, address, website, industry code, founding date, fiscal year end.
• Filings — the disclosure list for chosen companies or for the whole market in a date window: title (translated), filer, date, amendment flags and the DART viewer URL.
• Financial statements — every line of the balance sheet, income statement, comprehensive income, cash flow and equity statements from annual, half-year and quarterly reports, consolidated or separate, from fiscal 2015 onwards.
• Key financials for many companies at once — major accounts (assets, liabilities, equity, revenue, operating profit, net income…) for up to 100 companies per request.
• Financial indicators — profitability, stability, growth and activity ratios computed by DART (fiscal 2023 Q3 onwards).

Tutorial

1. No API key needed — just run it. The Actor uses its built-in shared key with a fair-use cap of 300 OpenDART requests per run.
2. Choose What to fetch (mode) and list your Companies — tickers such as 005930, DART corp codes such as 00126380, or names in English or Korean such as Samsung Electronics or 현대자동차. The Actor downloads DART's master list once, caches it for a week, and resolves names for you, logging what it matched.
3. For financial modes, set Fiscal years and Report types. For filings, set the date range and optionally the categories.
4. Run. Results land in the dataset; download them as JSON, CSV or Excel, or call the Actor from an AI agent through the Apify MCP server.

A cheap first test: mode key_financials, companies 005930, 000660, 005380, years 2024, report 11011. That is one request and a few dozen records.

Optional: use your own key

For larger runs, get a free personal key at https://opendart.fss.or.kr: register, then open 인증키 신청/관리 (API key request). Paste it into OpenDART API key. Personal keys allow up to 20,000 requests per day; the secret input is encrypted and is only sent to opendart.fss.or.kr. A non-empty personal key always takes precedence over the built-in key.

Use bundled sample data

Turn on Use bundled sample data (useSampleData: true) to return bundled records for the selected mode, capped by Max results, without an OpenDART request or record charge. This setting overrides both personal and built-in keys. Other filters do not change the bundled sample and are listed once in the run log; sample items carry sample: true.

Use from Claude, ChatGPT or any MCP agent

Add this Actor to an AI agent through the Apify MCP server — no code needed:

https://mcp.apify.com?tools=elpalaiso/dart-korea-filings-financials

In Claude Desktop: Settings → Connectors → Add custom connector → paste the URL and approve the Apify login. Then ask, for example:

• "Pull Samsung Electronics' FY2024 consolidated income statement from DART and compute the operating margin."
• "Compare total assets and net income of 005930, 000660 and 005380 for 2023 and 2024 from official filings."
• "List every material-event filing (B001) by KOSPI companies in the last two weeks with links."

No API key is needed for standard agent runs: the Actor uses its built-in shared key with a 300-request fair-use cap. For larger runs, give the agent your own OpenDART key once (apiKey); it is stored encrypted in the run input and only sent to opendart.fss.or.kr. Set useSampleData: true when the agent only needs to inspect the output shape for free.

Pricing

You pay per record delivered, nothing per run beyond Apify's tiny actor-start fee:

• Financial statement line (financial-line) — used by financials and key_financials
• Filing (filing)
• Company profile (company-profile)
• Financial indicator (indicator)

Empty results (for example a company that has no consolidated statements) cost nothing. Set a maximum total charge on the run to cap spend; the Actor stops cleanly when it is reached and tells you how many records were saved.

Input and output examples

Input for full 2024 consolidated statements of two companies:

{
  "mode": "financials",
  "companies": ["005930", "Hyundai Motor"],
  "years": ["2024"],
  "reportCodes": ["11011"],
  "fsDiv": "CFS",
  "requestBudget": 10
}

Input for KOSPI annual reports and large-shareholding reports across the market:

{
  "mode": "filings",
  "companies": [],
  "startDate": "2026-06-01",
  "endDate": "2026-09-01",
  "filingDetailTypes": ["A001", "D001"],
  "market": "Y"
}

filingDetailTypes accepts OpenDART's four-character detail codes and queries each supplied code separately. market accepts Y (KOSPI), K (KOSDAQ), N (KONEX), E (unlisted/other), or all (no market filter).

One output record:

{
  "record_type": "financial_line",
  "company_name_en": "SAMSUNG ELECTRONICS CO,.LTD",
  "company_name_ko": "삼성전자",
  "ticker": "005930",
  "corp_code": "00126380",
  "fiscal_year": 2024,
  "report_type": "Annual report",
  "basis": "Consolidated",
  "statement": "Balance sheet",
  "account_id": "ifrs-full_Assets",
  "account_name_en": "Total assets",
  "account_name_ko": "자산총계",
  "is_key_account": true,
  "current_period": "제 56 기",
  "current_amount": 514531948000000,
  "prior_amount": 455905980000000,
  "two_years_prior_amount": 448424507000000,
  "currency": "KRW",
  "filing_url": "https://dart.fss.or.kr/dsaf001/main.do?rcpNo=20250311000123"
}

Filing records carry report_title_en, report_title_ko, filed_date, remarks (decoded flags such as "Includes consolidated statements" or "Amended filing exists") and filing_url. Indicator records carry indicator_class, the original Korean indicator_name, the dictionary-backed indicator_name_en (or null for an unknown name), and a numeric indicator_value.

Recommendations

• Use tickers or corp codes when you can; names are matched against DART's master list and listed companies win ties, but subsidiaries with similar names exist.
• Quarterly and half-year income statement lines report the three-month figure in current_amount and the year-to-date figure in current_cumulative_amount, following DART's convention.
• account_name_en comes from a curated dictionary of common K-IFRS accounts, falling back to the XBRL tag name. Rare custom accounts keep their Korean name with an English label derived from the tag, or null when DART provides no standard tag — filter on is_key_account for the subtotals most analyses need.
• The filings mode without companies searches the whole market, which OpenDART limits to a three-month window per query.
• Set requestBudget to cap actual OpenDART HTTP requests, including the company master download and retries. With your own key, 0 means unlimited. With the built-in key, 0 applies the fair-use cap of 300 requests per run. When the budget is reached, the Actor keeps partial results and exits successfully.
• Daily quota is 20,000 requests per key; a full-statement pull is one request per company, year, report type and basis.

FAQ

Where does the data come from? OpenDART is the official public API of Korea's Financial Supervisory Service. The Actor returns structured data and links to the original filings; filing content remains subject to the FSS's copyright notice.

Why do I get "No data" for a company? Small companies often file separate (OFS) statements only — switch Consolidated or separate to OFS or both. Indicators exist only from fiscal 2023 Q3.

Can an AI agent use this? Yes. Add the Actor to the Apify MCP server and Claude, Cursor or any MCP client can call it with plain-language instructions; the input descriptions are written for that.

What is not covered yet? Original filing documents (PDF/XBRL downloads), shareholder and executive tables, and dividend histories. Ask for them in the Issues tab; they are on the roadmap.