Docs/Reference/Shareholdings/List Latest Shareholdings
GET/v1/shareholdings/latestTier · Developer

List Latest Shareholdings

Get the latest large shareholding reports across all companies.

Returns per-holder rows ordered by base date (newest first).

Query parameters · 3

Optional filters and modifiers. Pass as URL-encoded ?key=value.

limitintegeroptional

Results per page

default 50
offsetintegeroptional

Results to skip (ignored when cursor is set)

default 0
cursorstring | nulloptional

Opaque cursor for keyset pagination

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

The standard { data, meta } envelope. data contains an array of ShareholdingOut.

Envelope

dataShareholdingOut[]

Array of result objects.

metaMeta

Pagination and request metadata, including request_id, data_as_of, and ontology_version.

ontology_version 2.1.0replay meta.as_of · ?as_of=<token>

ShareholdingOut

idinteger

Row identifier. Pass to /shareholdings/{id}/audit for full provenance.

filer_edinet_codestring

EDINET code of the filer (investor)

issuer_security_codestring | null

Securities code of the issuer (target company)

issuer_namestring | null

Name of the issuer (target company)

holder_namestring | null

Name of the holder

holder_typestring | null

'individual' or 'corporation'

shares_heldinteger | null

Total shares held

holding_ratio_pctnumber | null

Holding ratio as percentage

previous_holding_ratio_pctnumber | null

Holding ratio from previous report

total_outstanding_sharesinteger | null

Total outstanding shares of the issuer

purpose_of_holdingstring | null

Purpose of holding (original Japanese)

holding_purpose_categorystring | null

Classified purpose. One of: pure_investment, portfolio_investment, cross_holding, management_participation, activist, going_private, tender_offer_offeror, tender_offer_target, trading_inventory, other.

purpose_confidencenumber | null

Calibrated probability of holding_purpose_category. Filter by threshold (e.g. >= 0.9) to get the highest-confidence subset.

purpose_alternative_labelstring | null

Second-most-likely category for this row. Inspect when purpose_confidence is moderate to see the runner-up.

purpose_alternative_probabilitynumber | null

Probability of purpose_alternative_label.

purpose_validatedboolean | null

True when the predicted category passed cross-check consistency. False marks borderline rows worth review.

purpose_classifier_versionstring | null

Opaque label for the classifier configuration applied to this row.

purpose_retrospective_labelstring | null

Most-active category disclosed by the same filer×issuer pair at any point. When equal to holding_purpose_category, no later evidence shifted the picture. When different, later evidence revealed an intent the row's real-time label didn't show, the disagreement is the signal.

purpose_retrospective_cutoffstring · date | null

base_date of the filing that set purpose_retrospective_label. Use to avoid look-ahead bias in backtests: 'as of this row's base_date the real-time label is what was knowable; the retrospective label uses evidence through this cutoff.'

format date
has_important_proposalboolean

Whether the holder intends to make an important proposal

default false
base_datestring · date

Base date of the report

format date
report_typestring

Report type: 'initial', 'amendment', or 'correction'

filing_reasonstring | null

Reason for filing (amendments only)

doc_idstring | null

EDINET document ID for source traceability

Errors

Standard HTTP status codes plus a typed error.code in the { error: { code, message } } envelope.

Every endpoint returns the same typed error envelope ({ error: { code, message } }). For the full list of codes, see the Errors reference.