財務指標

EDINETコード（例 E02367）

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）と /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 のまま）。