Docs/リファレンス/大量保有報告/大量保有報告書の取得
GET/v1/companies/{code}/shareholdingsプラン · Developer

大量保有報告書の取得

企業の大量保有報告書を取得します。5%以上の大量保有者の報告を返します。

パスパラメータ · 1

URLパスに展開される変数。

codestring必須

EDINETコードまたは証券コード

クエリパラメータ · 6

任意のフィルターと修飾子。URLエンコードした ?key=value で渡します。

date_fromstring · date | null任意

開始日（inclusive）

format date
date_tostring · date | null任意

終了日（inclusive）

format date
report_typestring | null任意

報告種別でフィルタ。'initial'（新規）、'amendment'（変更）、'correction'（訂正）。

limitinteger任意

1ページあたりの件数

default 50
offsetinteger任意

スキップする件数（cursor指定時は無視）

default 0
cursorstring | null任意

キーセットページネーション用カーソル

リクエストヘッダー · 1

認証ヘッダー。

Authorizationstring必須

本番用のAPIキー。次の形式で渡します: Bearer ax_live_…

返り値 · 200

標準の { data, meta } エンベロープ。 data は ShareholdingOut 型の配列です。

エンベロープ

dataShareholdingOut[]

結果オブジェクトの配列。

metaMeta

ページネーションとリクエストメタデータ。request_id、data_as_of、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コード。

issuer_security_codestring | null

対象企業の証券コード。

issuer_namestring | null

対象企業名。

holder_namestring | null

保有者名。

holder_typestring | null

'individual'（個人）または'corporation'（法人）。

shares_heldinteger | null

保有株式数。

holding_ratio_pctnumber | null

保有比率（%）。

previous_holding_ratio_pctnumber | null

前回報告時の保有比率。

total_outstanding_sharesinteger | null

対象企業の発行済株式総数。

purpose_of_holdingstring | null

保有目的（原文）。

holding_purpose_categorystring | null

保有目的分類。pure_investment、portfolio_investment、cross_holding、management_participation、activist（重要提案行為、ただし完全子会社化等の文言を含まない）、going_private（完全子会社化・非公開化・株式併合）、tender_offer_offeror（公開買付者として）、tender_offer_target（公開買付の対象、不応募・応募契約）、trading_inventory、other。ルールバージョン2.0.0。

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

重要提案を行う予定があるかどうか。

default false
base_datestring · date

報告基準日。

format date
report_typestring

報告種別。'initial'（新規）、'amendment'（変更）、'correction'（訂正）。

filing_reasonstring | null

変更報告の提出事由（変更報告書のみ）。

doc_idstring | null

EDINET書類管理番号。原本のトレーサビリティ用。

エラー

標準のHTTPステータスコードに加え、{ error: { code, message } } エンベロープ内で型付きの error.code を返します。

すべてのエンドポイントは共通の型付きエラーエンベロープ（{ error: { code, message } }）を返します。 全コードの一覧はエラーリファレンスを参照してください。