人物の役員報酬履歴
企業ごとの年度別役員報酬（報酬 1 億円超の個別開示に基づく）を返す。報酬データが無い人物は companies が空配列。該当データが 0 件のときは空配列とともに reason (code=no_results + 状況の説明) を返す。
GET
/persons/{id}/compensation-historyAuthorization
AuthorizationBearer token · headerrequiredIRBANK Connect (app.irbank.net/mcp-api) で発行した API キー
Path parameters
idstringrequired人物 ID（数値文字列）
matches ^\d+$
Responses
200OK（報酬データなしの人物も 200 + 空配列）
person_idstringrequired人物 ID
namestringrequired氏名
companiesPersonCompanyCompensation[]required企業別の報酬履歴。報酬データが無い人物は空配列
Show propertiesHide properties
Array of
PersonCompanyCompensationsecurity_codestringrequired証券コード (4 桁)
company_namestringrequired企業名
historyPersonCompensationFiscalYear[]required年度ごとの報酬（古い順）。報酬 1 億円超の個別開示行が対象
Show propertiesHide properties
Array of
PersonCompensationFiscalYearfiscal_period_endstringrequired会計期末日 (YYYY-MM-DD)
total_compnumber | nullrequired報酬総額（円）
fixed_compnumber | nullrequired固定報酬（円）。内訳未取得の年度は null
performance_compnumber | nullrequired業績連動報酬（円）。内訳未取得の年度は null
stock_compnumber | 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/compensation-history" \
-H "Authorization: Bearer YOUR_TOKEN"const response = await fetch("https://api.irbank.net/v1/persons/4837261950/compensation-history", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_TOKEN"
}
});import requests
response = requests.get(
"https://api.irbank.net/v1/persons/4837261950/compensation-history",
headers={
"Authorization": "Bearer YOUR_TOKEN"
},
)Response
{
"person_id": "string",
"name": "string",
"companies": [
{
"security_code": "7203",
"company_name": "トヨタ自動車",
"history": [
{
"fiscal_period_end": "2024-03-31",
"total_comp": 0,
"fixed_comp": 0,
"performance_comp": 0,
"stock_comp": 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"
}
]
}
}