--- search: tags: - financials - GET seo: description: >- 上場法人の財務時系列 (最大 30 期, asof 起点) を返す。 Reference for the GET /financials endpoint in the IRBANK API API. sidebar: badge: GET label: 財務時系列 title: 財務時系列 type: openapi-operation --- 上場法人の財務時系列 (最大 30 期, `as_of` 起点) を返す。 ## 対象の指定 - `edinet_code` または `security_code` のどちらか一方を指定する。 - `security_code` は法人の主たる上場銘柄 (本体株式・4 桁) のみ指定可。法人の主たる EDINET 提出者へ解決して返す (レスポンスの `edinet_code` に解決結果を含む)。 ## 期間の単位 (`period`) 年次 (`annual`, 既定)・四半期 (`quarterly`)・半期 (`semiannual`) を選択できる。 ### `annual` - 各暦年 1 期 (canonical な 12 ヶ月期) を返し、決算期変更に伴う移行短期決算 (3 ヶ月・9 ヶ月等) の開示値は含まない (取込み元データの期間が誤っている一部の法人では同一暦年に 2 期が残ることがある)。 - 実 12 ヶ月決算が無い暦年は、直近 12 ヶ月換算値が収録されていればそれで補完する (開示四半期実績からの推計値で、開示書類の数値とは一致しない)。 - 換算値も無い場合は期末残高 (BS 項目) のみの期で補完し、この期はフロー項目 (売上高・利益等) が null になる。 - 決算期変更の結果その暦年に決算期末が存在しない場合は、その暦年の期を返さない。 ### `semiannual` - 上期累計 (`H1`) + 通期 (`full_year`) を返す。 - CF を半期のみ開示する企業の `operating_cf` / `investing_cf` はこのモードで取得できる (`quarterly` では単四半期行が存在せず null になる)。 ## 返す項目 - 財務諸表の全収録項目 (PL / BS / キャッシュフロー / 配当 / バリュエーション / 人的資本 / ESG 約 100 項目)。 - EPS / BPS / ROE / DPS の計算値・株式分割調整値 (`eps_computed` / `eps_computed_adjusted` / `eps_adjusted` / `diluted_eps_adjusted` / `bps_computed` / `bps_computed_adjusted` / `bps_adjusted` / `roe_computed` / `dps_adjusted` / `dps_q2_adjusted` / `dps_year_end_adjusted`)。 - 未開示・非対象の項目は null。 - 残高 (期末時点) 系の項目 (総資産等の BS 項目・現金及び現金同等物 等) は `period=quarterly` / `semiannual` では `full_year` 行にのみ値が入る。 ## 単位 - 金額系は円 (`jpy`, 整数)、1 株当たり指標は円/株、比率は報告値そのまま。 - 各数値プロパティの単位はレスポンスの `fields[].unit` に機械可読で付与 (self-describing)。 ## 期ラベル (`is_consolidated` / `accounting_standard`) いずれも期単位の要約で、値を返す項目のうち有価証券報告書「主要な経営指標等」の代表 6 項目 (売上高 / 当期純利益 / 総資産 / 純資産 / 営業CF / 現金及び現金同等物) を母数に算出する (母数を固定するのは、取得項目数によってラベルが変わらないようにするため)。 - 代表 6 項目が 1 つも値を持たない期では代替の母数へフォールバックするため、下記の例外一覧から母数を逆算しても一致しないことがある。 - `period=quarterly` / `semiannual` では残高系の代表項目 (総資産 / 純資産 / 現金及び現金同等物) が `full_year` 行にしか入らず、単四半期 (Q1〜Q4) の母数は売上高・当期純利益が中心になる。 - `is_consolidated` は母数のうち連結として採用された項目の比率がしきい値以上なら true だが、最小件数の下限は課さないため、母数が薄い期では連結項目が過半に満たなくても true になることがある。 - 値の採用は項目ごとの連結優先・会計基準優先フォールバックのため、期ラベルと逆スコープ・異基準で採用された項目キーは各期の `scope_exceptions` / `standard_exceptions` に列挙される (`scope_exceptions` が空配列 / `standard_exceptions` が空オブジェクトなら、値を返す全項目が期ラベルと同一)。 ## 空レスポンス 該当データが 0 件のときは空配列とともに reason (code=no_results + 状況の説明) を返す。