/south-korea-dart

name: south-korea-dart
description: "Look up South Korea companies for free via the official DART OpenAPI (opendart.fss.or.kr, Financial Supervisory Service) - company overview (CEO, corporate/business registration numbers, KOSPI/KOSDAQ/KONEX class), disclosure filing lists, and audited financial statements (balance sheet, income statement) straight from the source. DART is Korea's SEC EDGAR equivalent. Use for KYB / know-your-business checks on Korean listed and reporting companies, financial due diligence, and disclosure monitoring. Trigger on: 'DART', 'South Korea company', 'Korean company lookup', 'Korean financials', 'corp_code', 'KOSPI company', 'KOSDAQ company', 'is this a Korean public company', 'Korean disclosure filings', 'FSS DART'. DART is free and covers listed/reporting filers only; for private Korean companies and non-Korean jurisdictions it hands off to the paid regdata registry actors."
metadata:
  version: 1.0.0
  author: regdata
  tags:
    - dart
    - south-korea
    - korea
    - financials
    - disclosure
    - corp-code
    - kospi
    - kosdaq
    - kyb
    - due-diligence
    - free-api
    - government-registry
  triggers:
    - "DART lookup"
    - "South Korea company lookup"
    - "Korean company financials"
    - "corp_code resolution"
    - "Korean disclosure filings"
    - "is this a Korean public company"
    - "KOSPI KOSDAQ company check"
    - "KYB check Korean company"
    - "FSS DART OpenAPI"

south-korea-dart

Free, official South Korean company data from the DART OpenAPI, run by the Financial Supervisory Service (FSS). DART (Data Analysis, Retrieval and Transfer System) is Korea's SEC EDGAR equivalent. This skill needs no paid actor and no Apify token - just a free DART API key. Use it as the front door for Korean listed-company verification and financial due diligence, and route to the paid regdata actors when you need a private Korean company or a non-Korean jurisdiction.

Persona

You are a KYB / financial-due-diligence analyst verifying South Korean companies against the authoritative source - the FSS's own DART system, not a commercial aggregator. You resolve a company name to its `corp_code`, confirm it is a live reporting filer, read its disclosure history for signals, and pull audited financial statements (assets, revenue, net income) straight from the filings.

What this gives you (for free)

• **Company overview** - `corp_code`, Korean and English legal name, stock name and stock code, CEO name, market class (KOSPI / KOSDAQ / KONEX / other), corporate registration number (`jurir_no`), business registration number (`bizr_no`), address, homepage, phone, industry code, establishment date, and fiscal-year-end month.
• **Disclosure filing list** - the stream of statutory disclosures (periodic reports, material-event filings, audit reports) filterable by date range and disclosure type.
• **Financial statements** - line items from the balance sheet and income statement (single main accounts, or the full account set), each carrying the current-period and prior-period amounts, for annual and quarterly reports.

Data is Korean-government public disclosure, free to use. Read-only.

Authentication (free, one-time)

1. Register a free account at https://opendart.fss.or.kr and request an API key under **인증키 신청/관리** (API key application). The key is issued near-instantly by email - self-serve, no approval wait. 2. Every call takes the 40-character key as the `crtfc_key` query parameter:

export DART_KEY=your_40_char_dart_api_key
curl "https://opendart.fss.or.kr/api/company.json?crtfc_key=$DART_KEY&corp_code=00126380"

There is no per-call charge. Rate limit is **20,000 requests per day per key**; exceeding it blocks further calls until the daily reset. Batch and cache the `corp_code` map so you do not spend calls re-resolving names.

Before starting

Ask the user for whichever is missing:

• **Company name, stock code, or `corp_code`.** DART has **no name-search endpoint** - if you only have a name, you must first download the `corpCode.xml` mapping (endpoint 5), unzip it, and look the name up locally to get the 8-digit `corp_code`. Confirm the right match before pulling detail.
• **What they need** - just "is it a real reporting filer", a disclosure-history pack, or actual financial statements.

API reference

Base URL: `https://opendart.fss.or.kr/api` - every endpoint appends `?crtfc_key=YOUR_KEY`.

| # | Purpose | Method + path | Example | |---|---|---|---| | 1 | Company overview by corp_code | `GET /company.json?crtfc_key=KEY&corp_code={8-digit}` | `/company.json?crtfc_key=KEY&corp_code=00126380` | | 2 | Disclosure filing list | `GET /list.json?crtfc_key=KEY&corp_code={..}&bgn_de={YYYYMMDD}&pblntf_ty={type}` | `/list.json?...&bgn_de=20250101&pblntf_ty=A` | | 3 | Financials - single main accounts | `GET /fnlttSinglAcnt.json?crtfc_key=KEY&corp_code={..}&bsns_year={YYYY}&reprt_code={code}` | `/fnlttSinglAcnt.json?...&bsns_year=2025&reprt_code=11011` | | 4 | Financials - all accounts | `GET /fnlttSinglAcntAll.json?...&bsns_year={YYYY}&reprt_code={code}&fs_div={CFS\|OFS}` | `/fnlttSinglAcntAll.json?...&reprt_code=11011&fs_div=CFS` | | 5 | corp_code <-> name map (ZIP of XML) | `GET /corpCode.xml?crtfc_key=KEY` | `/corpCode.xml?crtfc_key=KEY` |

**curl pattern** (every endpoint takes the same `crtfc_key`):

curl "https://opendart.fss.or.kr/api/fnlttSinglAcnt.json?crtfc_key=$DART_KEY&corp_code=00126380&bsns_year=2025&reprt_code=11011"

**`corp_code` is an 8-digit string, keep leading zeros** (`00126380`, not `126380`) - it is DART's internal id and is NOT the same as the stock code or the corporate registration number. **`reprt_code`** selects the reporting period: `11011` = annual, `11013` = Q1, `11012` = half-year, `11014` = Q3.

Workflow: a South Korean public-company check

1. Resolve identity
   name?       GET /corpCode.xml  -> unzip -> search the XML for corp_name, read corp_code (8-digit)
   sto