発行体の大株主リスト

発行体起点の大株主リスト（EDINET 大量保有報告書ベース）。現在有効な保有情報を保有比率降順で返す。各数値プロパティの単位は fields[].unit に機械可読で付与 (self-describing)。該当データが 0 件のときは空配列とともに reason (code=no_results + 状況の説明) を返す。

GET/shareholders

Authorization

AuthorizationBearer token · headerrequired

IRBANK Connect (app.irbank.net/mcp-api) で発行した API キー

Query parameters

edinet_codestringrequired

発行体 (被保有銘柄の発行者) の EDINET コード (E + 5 桁の数字)

matches ^[EG]\d{5}$

Responses

200OK

fieldsShareholderFieldUnit[]required

数値プロパティの単位メタデータ (self-describing)

Show properties

Array of ShareholderFieldUnit

keystringrequired

shareholders[] 各要素内の数値プロパティのキー

labelstringrequired

日本語の表示名

unitstringrequired

単位識別子 (percent / shares 等)

notestring

補足

shareholdersShareholder[]required

現在有効な大株主 (保有比率降順)。該当なしは空配列

Show properties

Array of Shareholder

holder_namestringrequired

保有者名

holding_rationumberrequired

保有比率 (%)

shares_heldnumberrequired

保有株数 (株)

previous_rationumber | nullrequired

前回報告時の保有比率 (%)。初回大量保有報告書は null

reasonEmptyReason | anyrequired

本体データが空のとき、その理由 (機械可読な code + 説明・対処ヒント)。本体データが 1 件以上のときは null

Show properties

One of:

EmptyReason

codestringrequired

no_results: このリクエストに該当するデータが 0 件。収録が無い場合と、指定した条件に合致しない場合の両方を含む (両者は現状の実装では区別できないため、機械可読な値としては区別しない)。TDnet 由来の値は開示から 24 時間は収録に反映されないため、直近開示分は後から追加され得る

Allowed:no_results

messagestringrequired

0 件になった状況の説明 (英語)。人間向けの補足であり、分岐は code で行うこと (文面は予告なく改善されうる)

any

any

attributionAttributionrequired

Show properties

source_labelstringrequired

出典表示ラベル（第三者に表示する際はこの表記を使う）

license_notestringrequired

出典・再配信条件の注記

processed_bystringrequired

400パラメータが不正

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

detailsExternalErrorDetail[]

Show properties

Array of ExternalErrorDetail

paramstringrequired

reasonstringrequired

Allowed:missingconflictinvalid_typeinvalid_formatout_of_rangeunknown_valuetoo_many_itemsinvalid

expectedstring

受理される値の要約（範囲・型・列挙値）。示せない場合は省略する

404発行体が存在しないか上場法人でない

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

detailsExternalErrorDetail[]

Show properties

Array of ExternalErrorDetail

paramstringrequired

reasonstringrequired

Allowed:missingconflictinvalid_typeinvalid_formatout_of_rangeunknown_valuetoo_many_itemsinvalid

expectedstring

受理される値の要約（範囲・型・列挙値）。示せない場合は省略する

Request

curl -X GET "https://api.irbank.net/v1/shareholders?edinet_code=E04430" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.irbank.net/v1/shareholders?edinet_code=E04430", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.irbank.net/v1/shareholders?edinet_code=E04430",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "fields": [
    {
      "key": "holding_ratio",
      "label": "保有比率",
      "unit": "percent",
      "note": "string"
    }
  ],
  "shareholders": [
    {
      "holder_name": "string",
      "holding_ratio": 0,
      "shares_held": 0,
      "previous_ratio": 0
    }
  ],
  "reason": {
    "code": "no_results",
    "message": "No segment disclosure is currently recorded for this organization."
  },
  "attribution": {
    "source_label": "金融庁 EDINET / TDnet",
    "license_note": "string",
    "processed_by": "IRBANK"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Security not found",
    "details": [
      {
        "param": "years",
        "reason": "out_of_range",
        "expected": ">= 1"
      }
    ]
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Security not found",
    "details": [
      {
        "param": "years",
        "reason": "out_of_range",
        "expected": ">= 1"
      }
    ]
  }
}