人物プロファイル
人物の氏名・生年月日と現任の役員就任先一覧を返す。全て退任済みの人物は current_appointments が空配列になる (氏名・生年月日は返る)。過去の就任先は GET /persons/{id}/appointments で取得する。
GET
/persons/{id}Authorization
AuthorizationBearer token · headerrequiredIRBANK Connect (app.irbank.net/mcp-api) で発行した API キー
Path parameters
idstringrequired人物 ID（数値文字列）
matches ^\d+$
Responses
200OK
person_idstringrequired人物 ID
namestringrequired氏名
birth_datestring | nullrequired生年月日 (YYYY-MM-DD)。不明の場合 null
current_appointmentsPersonCurrentAppointment[]required現任の役員就任先一覧。全て退任済みの人物は空配列 (氏名・生年月日は返るためレスポンス自体は空ではない。過去の就任先は GET /persons/{id}/appointments で取得する)
Show propertiesHide properties
Array of
PersonCurrentAppointmentsecurity_codestringrequired証券コード (4 桁)
security_namestringrequired企業名
rolestring | nullrequired役割（取締役 等）
positionstring | nullrequired役職名（代表取締役社長 等）
is_outsidebooleanrequired社外役員かどうか
first_valid_fromstring | nullrequired初回就任日 (YYYY-MM-DD)
tenure_yearsintegerrequired在任年数
min 0
attributionAttributionrequiredShow 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" \
-H "Authorization: Bearer YOUR_TOKEN"const response = await fetch("https://api.irbank.net/v1/persons/4837261950", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_TOKEN"
}
});import requests
response = requests.get(
"https://api.irbank.net/v1/persons/4837261950",
headers={
"Authorization": "Bearer YOUR_TOKEN"
},
)Response
{
"person_id": "string",
"name": "string",
"birth_date": "1960-03-15",
"current_appointments": [
{
"security_code": "7203",
"security_name": "トヨタ自動車",
"role": "string",
"position": "string",
"is_outside": true,
"first_valid_from": "2005-06-29",
"tenure_years": 0
}
],
"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"
}
]
}
}