directors kind is the monthly filing of shares held by directors, supervisors, managers and major shareholders, including the shares they have pledged as loan collateral. The major_shareholders kind is the exchange’s list of large holders, by name. Both are share counts, not money.
Plan: Free and above · Credits: 1 per call
What You Can Use Taiwan Ownership For
Track what a Taiwan company’s chairman, directors and officers hold month by month. Find insiders who have pledged a large share of their holding, a governance signal a price chart does not show. See who the exchange lists as a company’s major shareholders. This is domestic insider ownership. For how much of a company foreign investors hold, use Taiwan Foreign Ownership, which answers a different question.Directors’ and Officers’ Holdings
kind=directors is the default. Each row is one person in one role for one month.
title is the role as filed, in Chinese: for example 董事長本人 (the chairman), 董事本人 (a director), 獨立董事本人 (an independent director), 副總經理本人 (a vice president), 大股東本人 (a major shareholder), and 董事之法人代表人 (the representative of a corporate director).
current_shares is the holding. elected_shares is the holding at election, and is 0 for officers who were not elected. pledged_shares is the number pledged, and pledged_pct is pledged shares as a percentage of current_shares, on a 0-to-100 scale.
One Person Can Appear Under Several Titles
The Major-Shareholder List Carries No Holding Size
The list is a snapshot taken on most days, so the same name repeats once persnapshot_date. Take the newest snapshot_date rather than reading the repeats as separate holdings.
Not every company has rows in the list. TSMC (2330), for example, returns none.
Taiwan Ownership Date Convention
Directors’ holdings are monthly.period is the month, YYYY-MM, and report_date is when it was filed. date_gte and date_lte take YYYY-MM-DD, but only the month is compared, so any day in a month selects that month.
Major-shareholder rows are dated by snapshot_date, YYYY-MM-DD, and date_gte and date_lte compare the full date.
Rows are returned newest first.
Page Through One Month at a Time
Passnext_cursor back as cursor to get the next page. A person listed under two titles in the same month can straddle a page boundary, so fetch one month per request with date_gte, date_lte and a limit large enough to hold it.
Taiwan Ownership Coverage
Directors’ holdings run monthly from 2026-06. The major-shareholder list runs from 2026-07-23. Both are recent additions, so there is no longer history to backfill.GET /v1/companies/{company_id}/tw/ownership
Directors’ and officers’ holdings, or the major-shareholder list, newest first.string
required
A Taiwan security code such as
2330, a suffixed ticker such as 2330.TW or 6976.TWO, an ISIN or a company_id.string
default:"directors"
directors or major_shareholders.string
Part of the holder’s name. Matches
holder_name for directors and shareholder_name for major shareholders.string
Earliest date,
YYYY-MM-DD. For directors, only the month is compared.string
Latest date,
YYYY-MM-DD. For directors, only the month is compared.string
next_cursor from the previous page.integer
default:"100"
Rows per page, between 1 and 1000.