kr path. Each row is one line of one table in one report, in the filing’s own Korean, and every row links back to the original DART document. Coverage runs from 2022 onward.
Plan: Free and above · Credits: 1 per call
What You Can Use Korea Capital For
Track issued, treasury and outstanding shares, and the buybacks and cancellations that move them. Read the dividend per share, payout ratio and yield a company reported for the year. List the stakes a company holds in other companies, with book value and each investee’s own assets and net income. Build a debt maturity profile from bonds and commercial paper.Share Structure
/kr/share-structure has three kinds.
total is the share count table. category names the row: 보통주 for common, 우선주 for preferred, 합계 for the total, and 비고 for the notes line. Each row carries authorized_shares, cumulative_issued_shares, cumulative_reduced_shares and its breakdown, issued_shares, treasury_shares and shares_outstanding.
treasury is treasury-share movement for the period: beginning_treasury_shares, treasury_acquired, treasury_disposed, treasury_retired and ending_treasury_shares, per stock_class.
capital_change lists changes to share capital, with change_date, change_method, change_stock_class, change_shares, par_value and issue_or_reduction_price. A row of - values means the filer reported no change.
Dividends Are a Table of Items, Not a Calendar
/kr/dividends is the annual dividend table from the periodic report. Each row is one line item, named in Korean in item_ko: cash dividend per share, dividend yield, payout ratio, total cash dividends, net income, earnings per share and par value.
It has no ex-dividend date and no payment date. It is not a dividend calendar.
share_class separates common (보통주) and preferred (우선주) where the item is per share. It is - for company-level items.
The Dividend Unit Is Written Inside the Item Name
value_num is the figure as a number. value_text keeps it exactly as printed, including - for an item the filer left blank, in which case value_num is null. value_prior_num is the prior period’s figure from the same table.
Investments in Other Companies
/kr/investments lists the stakes the company holds in other companies. Each row names the investee_name and investment_purpose, with initial_acquisition_date and initial_acquisition_amount, holdings at the start and end of the period in beginning_shares, beginning_pct, beginning_book_value, ending_shares, ending_pct and ending_book_value, the movement in period_shares_change, acquisition_disposal_amount and valuation_gain_loss, and the investee’s own investee_total_assets and investee_net_income.
This section has no kind. Passing kind returns 404.
Debt
/kr/debt covers bonds and commercial paper. The kind parameter filters on the row’s debt_type field.
corp_bond_issue is the issuance ledger. Each row is one issue, with security_type, issuer, issue_date, maturity_date, face_value_total, interest_rate, rating_agency, repayment_status, issue_method and lead_manager. Dates and rates are text as filed, such as 1997.10.02 and 7.70%.
cp, short_bond, corp_bond, hybrid and contingent are outstanding-balance tables: commercial paper, short-term bonds, corporate bonds, hybrid securities and contingent convertible securities. Each carries total_outstanding, issue_limit and remaining_limit where the table has them, and the balance split into maturity buckets such as maturity_under_1_year, maturity_1_to_2_years and maturity_over_10_years.
Filter to One Kind Before Summing
Key Korea Capital Fields
Amounts are in KRW, except in the dividend table, whereunit_multiplier sets the scale. Share counts are counts. Percentages are on a 0-to-100 scale. Numbers arrive as strings, exactly as filed.
Every row carries rcept_no, the DART receipt number, and filing_url, the original DART document. Cite that when quoting a number.
Korea Capital Date Convention
Rows carrybsns_year, the business year, and report_period, which is annual, half, q1 or q3. settlement_date is the balance date the table describes. Filter with year. There is no report_period filter, so read it on each row.
These endpoints do not accept date_gte or date_lte; passing them returns 400.
Rows are returned newest filing first.
Korea Capital Coverage
Page Through One Kind at a Time
Passnext_cursor back as cursor to get the next page. Rows of different kinds can share a position inside one filing, so a page boundary can drop rows when you page through several kinds together. Filter to one kind, or ask for a limit large enough to take a year’s table in one page.
GET /v1/companies/{company_id}/kr/share-structure
Share count, treasury-share and capital-change tables, newest filing first.string
required
A Korean DART corp code (8 digits), a suffixed ticker such as
005930.KS, an ISIN or a company_id.string
total, treasury or capital_change. All three by default.integer
Business year.
string
next_cursor from the previous page.integer
default:"100"
Rows per page, between 1 and 1000.
GET /v1/companies/{company_id}/kr/dividends
The dividend table, one row per line item, newest filing first.string
required
A Korean DART corp code (8 digits), a suffixed ticker such as
005930.KS, an ISIN or a company_id.integer
Business year.
string
next_cursor from the previous page.integer
default:"100"
Rows per page, between 1 and 1000.
GET /v1/companies/{company_id}/kr/investments
Stakes held in other companies, newest filing first.string
required
A Korean DART corp code (8 digits), a suffixed ticker such as
005930.KS, an ISIN or a company_id.integer
Business year.
string
next_cursor from the previous page.integer
default:"100"
Rows per page, between 1 and 1000.
GET /v1/companies/{company_id}/kr/debt
The bond issuance ledger and outstanding-balance tables, newest filing first.string
required
A Korean DART corp code (8 digits), a suffixed ticker such as
005930.KS, an ISIN or a company_id.string
corp_bond_issue, cp, corp_bond, short_bond, hybrid or contingent. Matches the row’s debt_type. All six by default.integer
Business year.
string
next_cursor from the previous page.integer
default:"100"
Rows per page, between 1 and 1000.