銘柄の役員一覧
有価証券報告書の役員一覧に基づく、銘柄の役員（現任・退任済み・来期選任候補を含む）の人物単位の一覧を返す。並びは現任 → 来期選任候補 → 退任済みの順で、各グループ内は有報掲載順。各 person_id は GET /persons/{id}（プロファイル）・/appointments（就任履歴）・/compensation-history（報酬）・/holdings（保有株式）の入力に使える。該当データが 0 件のときは空配列とともに reason (code=no_results + 状況の説明) を返す。
GET
/securities/{code}/officersAuthorization
AuthorizationBearer token · headerrequiredIRBANK Connect (app.irbank.net/mcp-api) で発行した API キー
Path parameters
codestringrequired証券コード (4 桁)
matches ^[0-9A-Z]{4,5}$
Responses
200OK（役員データが無い銘柄は officers が空配列）
security_codestringrequired証券コード (4 桁)
officersSecurityOfficer[]required役員一覧（現任・退任済み・来期選任候補を含む人物単位のリスト。現任 → 来期選任候補 → 退任済みの順で、各グループ内は有価証券報告書の掲載順）
Show propertiesHide properties
Array of
SecurityOfficerperson_idstringrequired人物 ID（数値文字列）。GET /persons/{id} 系エンドポイントの入力に使う
namestringrequired氏名
rolestring | nullrequired役割（取締役 等）
positionstring | nullrequired役職名（代表取締役社長 等）
is_outsidebooleanrequired社外役員かどうか
is_currentbooleanrequired現任かどうか
is_next_term_nomineebooleanrequired来期選任予定（株主総会付議予定の役員候補で、まだ就任していない）かどうか
first_valid_fromstringrequired初回就任日 (YYYY-MM-DD)。来期選任候補（未就任）の場合は候補として掲載された開示の期日
last_valid_tostring | nullrequired最終退任日 (YYYY-MM-DD)。現任・来期選任候補（未就任）の場合 null
tenure_yearsintegerrequired在任年数。来期選任候補（未就任）は候補掲載期からの経過年数（参考値）
min 0
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/securities/7203/officers" \
-H "Authorization: Bearer YOUR_TOKEN"const response = await fetch("https://api.irbank.net/v1/securities/7203/officers", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_TOKEN"
}
});import requests
response = requests.get(
"https://api.irbank.net/v1/securities/7203/officers",
headers={
"Authorization": "Bearer YOUR_TOKEN"
},
)Response
{
"security_code": "7203",
"officers": [
{
"person_id": "4837261950",
"name": "山田太郎",
"role": "string",
"position": "string",
"is_outside": true,
"is_current": true,
"is_next_term_nominee": true,
"first_valid_from": "2005-06-29",
"last_valid_to": "string",
"tenure_years": 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"
}
]
}
}