年次配当実績

EDINET コード指定で法人の年次配当実績を古い順 (fiscal_year 昇順) で返す。1株配当 (報告時実額 / 分割・併合の遡及調整後) / 配当性向 / DOE / 純資産配当率 / 連続増配年数と根拠開示参照 (source_refs)。実績のみ — 配当予想・スケジュール・利回りは対象外。各数値プロパティの単位は fields[].unit を参照。該当データが 0 件のときは空配列とともに reason (code=no_results + 状況の説明) を返す。

GET/dividends

Authorization

AuthorizationBearer token · headerrequired

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

Query parameters

edinet_codestringrequired

EDINET コード (E または G + 5 桁の数字、例: E04430)

matches ^[EG]\d{5}$

from_fiscal_yearinteger

開始年度フィルタ (決算期末の西暦年 YYYY)。未指定時は最古年度から返す

min 1900 · max 2200

to_fiscal_yearinteger

終了年度フィルタ (決算期末の西暦年 YYYY)。未指定時は最新年度まで返す

min 1900 · max 2200

Responses

200OK

fieldsobject[]required

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

Show properties

Array of object

keystringrequired

records[] 内の対象数値プロパティのキー

labelstringrequired

日本語の表示名

unitstringrequired

単位識別子 (jpy_per_share / percent / years 等)

notestring

補足 (任意)

edinet_codestringrequired

security_codestringrequired

証券コード (4 桁)

recordsDividendRecord[]required

年次配当実績 (古い順、fiscal_year 昇順)

Show properties

Array of DividendRecord

fiscal_yearintegerrequired

決算期末の西暦年 (YYYY)

annual_dpsnumber | nullrequired

1株当たり年間配当 (円、報告時実額。分割・併合は未調整)

annual_dps_adjustednumber | nullrequired

分割・併合の遡及調整後 1株当たり年間配当 (円、最新株数基準)

payout_rationumber | nullrequired

配当性向 (%)

change_typestring | nullrequired

前年比増減区分 (分割・併合の遡及調整後 DPS の前年比で判定)

Allowed:newincreasedecreaseflatresumecutnull

doenumber | nullrequired

DOE (自己資本配当率、%)

net_asset_dividend_ratenumber | nullrequired

純資産配当率 (%)

consecutive_dividend_increase_yearsinteger | nullrequired

連続増配年数 (年)。欠損時 null

source_refsDividendSourceRef[]required

確定根拠開示への参照。当該年度の各値 (配当・配当性向に加え DOE / 純資産配当率 / 連続増配年数の算出元) が由来する開示を返す。source=tdnet の書類詳細は 2013 年 9 月以降の開示のみ GET /disclosures/{doc_id} で取得でき、それ以前の開示は書類マスタ未収録のため 404 になる (配当の数値自体はそれ以前も返る)

Show properties

Array of DividendSourceRef

doc_idstringrequired

根拠開示の書類 ID。GET /disclosures/{doc_id} に渡して詳細を取得できる (取得できない場合は下記 source_refs の注記を参照)

sourcestringrequired

開示ソース

Allowed:edinettdnet

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

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

404EDINET コードに対応する上場法人が存在しない

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/dividends?edinet_code=E04430" \
  -H "Authorization: Bearer YOUR_TOKEN"

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

import requests

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

Response

{
  "fields": [
    {
      "key": "string",
      "label": "string",
      "unit": "string",
      "note": "string"
    }
  ],
  "edinet_code": "string",
  "security_code": "7203",
  "records": [
    {
      "fiscal_year": 2025,
      "annual_dps": 0,
      "annual_dps_adjusted": 0,
      "payout_ratio": 0,
      "change_type": "new",
      "doe": 0,
      "net_asset_dividend_rate": 0,
      "consecutive_dividend_increase_years": 0,
      "source_refs": [
        {
          "doc_id": "string",
          "source": "edinet"
        }
      ]
    }
  ],
  "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"
      }
    ]
  }
}