POST /v1/batch/financials · APIリファレンス

リクエストヘッダー · 1

認証ヘッダー。

Authorizationstring必須

本番用のAPIキー。次の形式で渡します: Bearer ax_live_…

リクエストボディ · 3

JSONリクエストボディのフィールド。

codesstring[]必須

EDINETコードまたは証券コードのリスト（1〜100件）。

yearsinteger任意

企業ごとの取得年数（デフォルト: 5）。

default 5

fieldsstring[] | null任意

取得する財務フィールド。nullの場合は全フィールドを返す。

返り値 · 200

標準の { data, meta } エンベロープ。 data は FinancialOut 型の配列です。

エンベロープ

dataFinancialOut[]

結果オブジェクトの配列。

metaMeta

ページネーションとリクエストメタデータ。request_id、data_as_of、ontology_version を含みます。

ontology_version 2.1.0replay meta.as_of · ?as_of=<token>

FinancialOut

edinet_codestring

EDINET提出者コード（例: E02144）。

fiscal_yearinteger

決算年度。「2024」は2024年に終了する会計年度。

period_endstring · date

会計期間の末日（例: 2024-03-31）。

format date

revenueinteger | null

売上高（JPY）。IFRS企業は「Revenue」、日本基準は「売上高」または「営業収益」。未報告ならnull。

net_incomeinteger | null

親会社株主に帰属する当期純利益（JPY）。未報告ならnull。

operating_incomeinteger | null

営業利益（JPY）。非標準のPL形式を使用する企業はnull。

ordinary_incomeinteger | null

経常利益（JPY）。日本基準特有の項目で、営業外損益を含む。IFRS・US-GAAP企業はnull。

total_assetsinteger | null

総資産（JPY）。

total_equityinteger | null

非支配株主持分を含む資本合計（JPY）。

net_assetsinteger | null

純資産（JPY）。日本基準の概念で、非支配株主持分・新株予約権を含む。

total_liabilitiesinteger | null

負債合計（JPY）。

cash_and_equivalentsinteger | null

現金及び現金同等物（JPY）。BSの勘定科目で、CF末残高とは異なる。

operating_cfinteger | null

営業活動によるキャッシュフロー（JPY）。

investing_cfinteger | null

投資活動によるキャッシュフロー（JPY）。設備投資を含むため通常はマイナス。

financing_cfinteger | null

財務活動によるキャッシュフロー（JPY）。借入・返済・配当金支払を含む。

epsnumber | null

1株当たり当期純利益（円）。例: 285.23。当期純利益÷期中平均株式数で算出。

diluted_epsnumber | null

希薄化後1株当たり当期純利益（円）。転換社債、ストックオプション等を考慮。

dividends_per_sharenumber | null

1株当たり配当金（円）。無配の場合はnullまたは0。

bpsnumber | null

1株当たり純資産（円）。純資産÷発行済株式数で算出。

roenumber | null

自己資本利益率（%）。12.5なら12.5%。自己資本または当期純利益が取得できない場合はnull。

pe_rationumber | null

株価収益率。株価÷EPSで算出。EPSが0以下の場合はnull。

num_employeesinteger | null

従業員数（人数）。単位なしの整数。

payout_rationumber | null

配当性向（%）。例: 30.0なら30%。配当金÷当期純利益で算出。

capital_stockinteger | null

資本金（JPY）。

comprehensive_incomeinteger | null

包括利益（JPY）。当期純利益＋その他の包括利益。

income_before_taxinteger | null

税引前当期純利益（JPY）。

shares_issuedinteger | null

発行済株式総数。自己株式を含む。

shares_outstanding_at_filinginteger | null

提出日現在の発行済株式総数。DEIヘッダーから取得。

interim_dividendnumber | null

中間配当金（円/株）。dividends_per_shareの内数。

cost_of_salesinteger | null

売上原価（JPY）。

gross_profitinteger | null

売上総利益（JPY）。売上高から売上原価を差し引いた金額。

sgainteger | null

販売費及び一般管理費（JPY）。

extraordinary_incomeinteger | null

特別利益（JPY）。日本基準のみ。

extraordinary_lossinteger | null

特別損失（JPY）。日本基準のみ。

depreciationinteger | null

減価償却費（JPY）。PL注記またはCF調整項目に記載。

rnd_expensesinteger | null

研究開発費（JPY）。

current_assetsinteger | null

流動資産（JPY）。

noncurrent_assetsinteger | null

固定資産（JPY）。

ppeinteger | null

有形固定資産（JPY）。

intangible_assetsinteger | null

無形固定資産（JPY）。

inventoriesinteger | null

棚卸資産（JPY）。

trade_receivablesinteger | null

売掛金・受取手形（JPY）。

current_liabilitiesinteger | null

流動負債（JPY）。

noncurrent_liabilitiesinteger | null

固定負債（JPY）。

trade_payablesinteger | null

買掛金・支払手形（JPY）。

ibd_currentinteger | null

有利子負債（流動）（JPY）。短期借入金＋長期借入金の1年以内返済分。

ibd_noncurrentinteger | null

有利子負債（固定）（JPY）。長期借入金＋社債。

retained_earningsinteger | null

利益剰余金（JPY）。

non_controlling_interestsinteger | null

非支配株主持分（JPY）。

capexinteger | null

設備投資額（JPY）。投資CFの内訳から取得可能な場合に算出。

treasury_stockinteger | null

自己株式（JPY）。株主資本の控除項目のためマイナス表示。

goodwillinteger | null

のれん（JPY）。IFRSでは独立項目、日本基準では無形固定資産に含まれる。

interest_expenseinteger | null

支払利息（JPY）。

investment_securitiesinteger | null

投資有価証券（JPY）。

deferred_tax_assetsinteger | null

繰延税金資産（JPY）。

is_consolidatedboolean

連結データならtrue。子会社を持たない単体決算企業はfalse。

default true

accounting_standardstring | null

会計基準。'JP-GAAP'、'IFRS'、'US-GAAP'のいずれか。

currencystring

通貨コード。常に'JPY'。すべての金額は日本円。

default JPY

source_doc_idstring | null

出典のEDINET書類ID（例: 'S100ABCD'）。

data_sourcestring

データの出典情報。

default EDINET (Financial Services Agency of Japan)

explanationsobject | null

Explanations for null financial fields. Keys are field names, values explain why the field is null (e.g. accounting standard differences, data availability). Only present when include=explanations is requested (REST API) or always included in MCP tool responses.

sourcesobject | null

Per-field source citations tracing each value to its EDINET filing. Only present when include=sources is requested. Contains 'edinet_url', 'accounting_standard', and period dates.

roanumber | null

総資産利益率（%）。算出不可の場合はnull。

operating_marginnumber | null

営業利益率（%）。営業利益÷売上高×100で算出。

net_marginnumber | null

当期純利益率（%）。当期純利益÷売上高×100で算出。

gross_marginnumber | null

Gross margin (%). gross_profit ÷ revenue × 100.

equity_rationumber | null

自己資本比率（%）。純資産÷総資産×100で算出。

エラー

標準のHTTPステータスコードに加え、{ error: { code, message } } エンベロープ内で型付きの error.code を返します。

すべてのエンドポイントは共通の型付きエラーエンベロープ（{ error: { code, message } }）を返します。全コードの一覧はエラーリファレンスを参照してください。

リクエストcURL

curl -X POST "https://api.axiora.dev/v1/batch/financials" \
  -H "Authorization: Bearer ax_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "codes": [] }'

レスポンス · 200

200 OK

{
  "data": [
    {
      "edinet_code": "…",
      "fiscal_year": 0,
      "period_end": "…",
      "revenue": 0,
      "net_income": 0,
      "operating_income": 0,
      "ordinary_income": 0,
      "total_assets": 0
      // …more fields
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "total": 1,
    "limit": 50,
    "offset": 0,
    "next_cursor": null,
    "data_as_of": "2026-05-12T03:25:11Z",
    "ontology_version": "2.1.0",
    "as_of": "frz_01HRX9KQ2T8N7P4M"
  }
}

レスポンス · 401

401 UNAUTHORIZED

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid API key. Pass it as `Authorization: Bearer ax_live_…`."
  }
}