財務時系列データ

EDINETコード（例 E02367）。/searchまたは/companiesで取得できます。

取得年数（省略時は全期間。period=quarterly/quarterly_standalone でも有効）

annual=年次（既定、有報ベース）。 quarterly=YTD累計（FY2016-2024は四半期報告書でフルカバレッジ。FY2025以降もH1(Q2)は半期報告書により継続提供、Q1/Q3は決算短信/IR PDF統合。CF/BSは構造的に欠損ありうる）。 quarterly_standalone=単四半期（Q1直接、Q2/Q3=YTD(Q)-YTD(Q-1)、Q4=年次-YTD(Q3)。前期YTDが無い場合はflow値NULL(derivation_method=no_prev_ytd)、BSスナップショットは提供。derivation_method/has_prev_ytd/source_type をレスポンスに含む）。

true を指定するとレスポンスから null フィールドを省略せず、固定スキーマで返します。 デフォルト (false) では null のフィールドはレスポンスから省略されるため、 企業ごとに返却フィールド数が異なります（例: GHG 排出量・多様性指標などは 開示企業のみ含まれる）。 BigQuery への ELT や定期同期スクリプト等、固定スキーマで取り込みたい場合は ?include_nulls=true を指定してください。 対応エンドポイント: /companies/{code}, /companies/{code}/financials, /companies/{code}/ratios, /companies/{code}/earnings, /companies/{code}/real-estate, /companies/{code}/facilities。

変更履歴: 2026-07-18 — /financials に basis / basis_source（連結/単体ラベル）を additive 追加しました。?include_nulls=true で固定スキーマ取り込みをしている場合、 取込先スキーマに 2 カラムの追加が必要になることがあります（既存フィールドの型・意味は不変）。

/companies/{code}/financials（period=annual）専用。true を指定すると、各年度行に null_reasons オブジェクトを追加します。null かつ理由が決定論的に導出できるフィールドだけを 機械可読コードにマップします（推測はしません）。既定 (false) ではレスポンスは 1 バイトも変わりません。

コード（emit されうる 4 種）:

• not_applicable_accounting_standard: JP-GAAP 固有フィールドを IFRS/US GAAP 採用企業が提出（該当区分なし）
• not_required_for_fiscal_year: 当該年度は開示制度の開始前（例: GHG 排出量・男女賃金差異は FY2023 開始）
• not_applicable_industry_practice: 当該業種の開示慣行上その概念が使われない（例: 銀行業の営業利益）
• land_disclosed_in_combined_form: land が単独開示されず land_buildings_and_structures（土地・建物及び構築物の合算、非加算）でのみ開示（2026-08-22 追加）

null_reasons に載らないフィールドは「非 null」か「理由を特定できない」のいずれかです（unknown は返しません）。 これは系統的な null の一部をカバーするもので、全 null に理由が付くわけではありません。null は 0 を意味しません。 コードの凡例（ラベル・説明・docs_url）はレスポンスの meta.null_reason_codes に 1 回だけ入ります。 追加リクエスト・追加課金は発生しません（1 リクエスト = 1 unit のまま）。

/companies/{code}/financials（period=annual）と /companies/{code}/ratios 専用。true を指定すると、 meta.fields にこのレスポンスのスキーマが定義する全フィールドの自己記述カタログを追加します （key / label / unit / note の配列。note は本 openapi のフィールド説明を空白正規化した内容です。 内部の改行・連続空白は単一スペースに畳んでいるため、YAML 原文とバイト単位で完全一致するとは限りません）。 既定 (false) ではレスポンスは 1 バイトも変わりません。

/companies/{code}/financials で period=quarterly または period=quarterly_standalone を 指定した場合、本パラメータはサイレントに無視されます（400 エラーにはなりません。 include_null_reasons と同じ annual 限定スコープです）。

本パラメータは静的なスキーマカタログであり、レスポンスの各年度行の値そのものは変更しません （null_reasons のように行ごとに変わる注釈ではなく、レスポンス全体で 1 回だけ返ります）。 unit はフィールド説明文からのベストエフォート抽出で、決定できない場合は null になります （誤った単位を推測するより null の方が安全という方針です）。 併せて meta.attribution に出典（金融庁 EDINET）・EDINET DB としての加工表示・ 再配布ポリシー（bulk_redistribution: prohibited_b2b_license_required）を機械可読で返します （info.x-ai-policy と同一ポリシー。応答単体で出典を辿れるようにするためのものです）。 追加リクエスト・追加課金は発生しません（1 リクエスト = 1 unit のまま）。