人物の保有株式
銘柄（証券コード・名称）ごとの保有株式数と会計期末ごとの推移を返す。該当データが 0 件のときは空配列とともに reason (code=no_results + 状況の説明) を返す。
GET
/persons/{id}/holdingsAuthorization
AuthorizationBearer token · headerrequiredIRBANK Connect (app.irbank.net/mcp-api) で発行した API キー
Path parameters
idstringrequired人物 ID（数値文字列）
matches ^\d+$
Responses
200OK
person_idstringrequired人物 ID
holdingsPersonHolding[]required銘柄別の保有株式
Show propertiesHide properties
Array of
PersonHoldingsecurity_codestringrequired証券コード (4 桁)
security_namestringrequired企業名
is_currentbooleanrequired現任の就任先かどうか
latest_shares_heldinteger | nullrequired直近会計期末の保有株式数（株）
min 0
share_historyPersonShareHistoryEntry[]required会計期末ごとの保有株式数の推移（古い順）
Show propertiesHide properties
Array of
PersonShareHistoryEntryfiscal_period_endstringrequired会計期末日 (YYYY-MM-DD)
shares_heldintegerrequired保有株式数（株）
min 0
ownership_rationumber | nullrequired発行済株式数に対する保有比率。算出不能の場合 null
reasonEmptyReason | anyrequired本体データが空のとき、その理由 (機械可読な code + 説明・対処ヒント)。本体データが 1 件以上のときは null
Show propertiesHide properties
One of:
EmptyReason
codestringrequiredno_results: このリクエストに該当するデータが 0 件。収録が無い場合と、指定した条件に合致しない場合の両方を含む (両者は現状の実装では区別できないため、機械可読な値としては区別しない)。TDnet 由来の値は開示から 24 時間は収録に反映されないため、直近開示分は後から追加され得る
Allowed:
no_resultsmessagestringrequired0 件になった状況の説明 (英語)。人間向けの補足であり、分岐は code で行うこと (文面は予告なく改善されうる)
any
anyattributionAttributionrequiredShow propertiesHide properties
source_labelstringrequired出典表示ラベル（第三者に表示する際はこの表記を使う）
license_notestringrequired出典・再配信条件の注記
processed_bystringrequired400パラメータが不正
errorobjectrequiredShow propertiesHide properties
codestringrequiredmessagestringrequireddetailsExternalErrorDetail[]Show propertiesHide properties
Array of
ExternalErrorDetailparamstringrequiredreasonstringrequiredAllowed:
missingconflictinvalid_typeinvalid_formatout_of_rangeunknown_valuetoo_many_itemsinvalidexpectedstring受理される値の要約（範囲・型・列挙値）。示せない場合は省略する
404人物が存在しない
errorobjectrequiredShow propertiesHide properties
codestringrequiredmessagestringrequireddetailsExternalErrorDetail[]Show propertiesHide properties
Array of
ExternalErrorDetailparamstringrequiredreasonstringrequiredAllowed:
missingconflictinvalid_typeinvalid_formatout_of_rangeunknown_valuetoo_many_itemsinvalidexpectedstring受理される値の要約（範囲・型・列挙値）。示せない場合は省略する
Request
curl -X GET "https://api.irbank.net/v1/persons/4837261950/holdings" \
-H "Authorization: Bearer YOUR_TOKEN"const response = await fetch("https://api.irbank.net/v1/persons/4837261950/holdings", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_TOKEN"
}
});import requests
response = requests.get(
"https://api.irbank.net/v1/persons/4837261950/holdings",
headers={
"Authorization": "Bearer YOUR_TOKEN"
},
)Response
{
"person_id": "string",
"holdings": [
{
"security_code": "7203",
"security_name": "トヨタ自動車",
"is_current": true,
"latest_shares_held": 0,
"share_history": [
{
"fiscal_period_end": "2024-03-31",
"shares_held": 0,
"ownership_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"
}
]
}
}