Plan: Free and above · Credits: 1 per call
What You Can Use Korea Shareholders For
Follow insider buying and selling at a Korean company filing by filing. Track a 5% holder’s stake as it builds or unwinds. Read the controlling shareholder and its related parties from the annual register. See how much of the company minority shareholders hold.Two Endpoints, Two Grains
/kr/ownership is event-based. Each row is one filing, dated by report_dt, and you filter it with date_gte and date_lte. It has no year or report_period.
/kr/shareholders is per periodic report. Each row belongs to one report for one business year, and you filter it with year. It does not accept date_gte or date_lte; passing them returns 400.
Ownership Kinds
kind separates the two filing types behind /kr/ownership. They follow different reporting rules and carry different fields.
major_5pct is a 5%-holder report. It carries reporter, report_type, report_reason, the block in shares and ownership_pct, the change in shares_change and ownership_pct_change, and any shares under contract in contract_shares and contract_ownership_pct.
insider is an executive or major-shareholder ownership report. It carries reporter, executive_position, is_registered_executive, is_major_shareholder, the holding in owned_shares and owned_pct, and the change in owned_shares_change and owned_pct_change.
Fields that belong to the other kind are null.
Shareholder Register Kinds
kind separates the three tables behind /kr/shareholders.
major is the largest shareholder and its related parties. Each row names the shareholder_name, its relationship to the largest shareholder and the stock_class, with holdings at the start and end of the period in beginning_shares, beginning_pct, ending_shares and ending_pct.
minority is the minority-shareholder summary: shareholder_count against total_shareholder_count, and held_shares against total_shares, each with its percentage.
major_change lists changes of the largest shareholder, with change_date and change_cause. A row of - values means the filer reported no change.
Filter to One Kind Before Summing
Key Korea Shareholder Fields
Share counts are counts, not money. Percentages are on a 0-to-100 scale. Numbers arrive as strings, exactly as filed. Text fields such asshareholder_name, relationship, stock_class and executive_position are the filing’s own Korean and are not translated. stock_class is 보통주 for common shares and 우선주 for preferred shares.
Every row carries rcept_no, the DART receipt number, and filing_url, the original DART document. Cite that when quoting a number.
Korea Shareholders Date Convention
Ownership rows are dated byreport_dt, the date the filing was made. date_gte and date_lte bound it.
Register rows carry bsns_year, report_period and settlement_date, the balance date the register describes. report_period is annual, half, q1 or q3. There is no report_period filter, so read it on each row.
Rows are returned newest filing first.
Korea Shareholders 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 register in one page.
GET /v1/companies/{company_id}/kr/ownership
Insider and 5%-holder filings, newest first.string
required
A Korean DART corp code (8 digits), a suffixed ticker such as
005930.KS, an ISIN or a company_id.string
insider or major_5pct. Both by default.string
Earliest report date,
YYYY-MM-DD.string
Latest report date,
YYYY-MM-DD.string
next_cursor from the previous page.integer
default:"100"
Rows per page, between 1 and 1000.
GET /v1/companies/{company_id}/kr/shareholders
The shareholder register from the periodic report, 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
major, minority or major_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.