kind.
Plan: Free and above · Credits: 1 per call
What you can use Japan ownership for
Spot a new 5% holder, or an existing one building or cutting its stake, with the date the obligation arose. Read the holder’s own stated purpose to see activist intent. Follow cross-shareholding unwinds between group companies. See who sits at the top of the register each year.Large-holding reports (kind=large_holdings, the default)
Each row is an event with a statutory trigger date, obligation_date (報告義務発生日). The filing is made by the holder, not the company, so holder_name is often an individual, a founder’s asset-management company or a foreign manager that appears in no company table.
holding_ratioandprev_holding_ratioare fractions (0.0829= 8.29%);ratio_changeis the difference.shares_heldandshares_outstandingare the share counts behind the ratio.purpose(保有目的) is the holder’s own statement of why it holds the stake — the field with no US equivalent. A holder that writes that it has no plan to make material proposals (重要提案行為等を行う予定はなく) is declaring it will not push the company; one that does not is the row to read.acquisition_funds,own_fundsandborrowed_fundsare disclosed only on an initial report, not on a change report, so most rows leave them null by design.is_amendmentmarks a correction to an earlier report.
Major-shareholder table (kind=major_shareholders)
The top-ten table out of the annual report: an annual snapshot with a rank and no event date. It carries different fields — rank, holder_name, holder_address, shares_held and shareholding_ratio (a fraction), plus period_end, filed_on, doc_id and filing_url. The table also appears in half-year reports, so group rows by doc_id and use filed_on to tell the snapshots apart; period_end can be null on some reports.
The top rows are usually trust-bank custodians (日本マスタートラスト信託銀行, 日本カストディ銀行) holding for someone else: a custodian is not a beneficial owner. This view returns every row that matches in one response; narrow it with date_gte / date_lte and limit.
Neither is a transaction feed
Japan publishes no equivalent of a US Form 4. For directors’ own holdings, see the annual share counts in Japan Officers; a director’s holding company that crosses 5% does appear here, with a trigger date.Japan ownership coverage
Every response carries a measuredcoverage block with the date range loaded, companies_covered and companies_tracked. For large-holding reports the dates are the trigger dates in the filings; for the major-shareholder table they are the annual reports loaded.
GET /v1/companies/{company}/jp/ownership
string
required
Tokyo symbol (
7203.T or 7203), five-digit EDINET security code, EDINET filer code, ADR symbol (TM), ISIN or company_id of the issuer.string
default:"large_holdings"
large_holdings (5% reports) or major_shareholders (the annual top-ten table).string
Earliest trigger date (large holdings) or period end (major shareholders),
YYYY-MM-DD; date_lte sets the ceiling.number
Minimum stake as a fraction (
0.05 = 5%). Applied per row — see the warning above.string
Substring of the holder’s name, Japanese or English.
integer
default:"100"
Rows per page, between 1 and 500. Large-holding rows are newest trigger date first and page with
cursor, passing back next_cursor unchanged.