POST /v1/batch/financials · API Reference

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Request body · 3

JSON request body fields.

codesstring[]required

List of EDINET or securities codes (1–100).

yearsintegeroptional

Number of fiscal years per company.

default 5

fieldsstring[] | nulloptional

Financial fields to include. Null returns all fields.

Returns · 200

The standard { data, meta } envelope. data contains an array of FinancialOut.

Envelope

dataFinancialOut[]

Array of result objects.

metaMeta

Pagination and request metadata, including request_id, data_as_of, and ontology_version.

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

FinancialOut

edinet_codestring

EDINET submitter code (e.g. 'E02144').

fiscal_yearinteger

Fiscal year label. '2024' means the fiscal year ending in calendar year 2024.

period_endstring · date

Last day of the fiscal period (e.g. '2024-03-31').

format date

revenueinteger | null

Revenue (売上高) in JPY. IFRS: Revenue; JP-GAAP: 売上高 or 営業収益.

net_incomeinteger | null

Net income attributable to owners of the parent in JPY. Null if not reported.

operating_incomeinteger | null

Operating income (営業利益) in JPY.

ordinary_incomeinteger | null

Ordinary income (経常利益) in JPY. JP-GAAP only; includes non-operating items.

total_assetsinteger | null

Total assets (総資産) in JPY.

total_equityinteger | null

Total equity including non-controlling interests in JPY.

net_assetsinteger | null

Net assets (純資産) in JPY. JP-GAAP concept; includes NCI and stock acquisition rights.

total_liabilitiesinteger | null

Total liabilities (負債合計) in JPY.

cash_and_equivalentsinteger | null

Cash and cash equivalents in JPY. BS item, not CF ending balance.

operating_cfinteger | null

Cash flow from operating activities in JPY.

investing_cfinteger | null

Investing cash flow in JPY. Typically negative.

financing_cfinteger | null

Financing cash flow in JPY. Negative = net repayment.

epsnumber | null

Basic EPS in JPY (e.g. 285.23).

diluted_epsnumber | null

Diluted EPS in JPY. Adjusts for convertibles/options.

dividends_per_sharenumber | null

Annual DPS in JPY (e.g. 75.0). Interim + year-end.

bpsnumber | null

Book value per share in JPY.

roenumber | null

Return on equity (%). E.g. 12.5 means 12.5%.

pe_rationumber | null

Price-to-earnings ratio. Derived from market price ÷ EPS when available.

num_employeesinteger | null

Number of employees (headcount). Unitless integer.

payout_rationumber | null

Payout ratio (%). E.g. 30.0 = 30%. Dividends / NI.

capital_stockinteger | null

Stated capital (資本金) in JPY.

comprehensive_incomeinteger | null

Comprehensive income in JPY. Net income + OCI.

income_before_taxinteger | null

Income before income taxes (税引前当期純利益) in JPY.

shares_issuedinteger | null

Total shares issued (発行済株式総数). Includes treasury stock.

shares_outstanding_at_filinginteger | null

Shares outstanding at filing date (提出日現在の発行済株式総数). DEI header.

interim_dividendnumber | null

Interim dividend per share in JPY. Subset of dividends_per_share.

cost_of_salesinteger | null

Cost of sales (売上原価) in JPY.

gross_profitinteger | null

Gross profit (売上総利益) in JPY. Revenue minus cost of sales.

sgainteger | null

Selling, general and administrative expenses (販管費) in JPY.

extraordinary_incomeinteger | null

Extraordinary income (特別利益) in JPY. JP-GAAP only.

extraordinary_lossinteger | null

Extraordinary loss (特別損失) in JPY. JP-GAAP only.

depreciationinteger | null

Depreciation and amortization in JPY.

rnd_expensesinteger | null

R&D expenses (研究開発費) in JPY.

current_assetsinteger | null

Current assets (流動資産) in JPY.

noncurrent_assetsinteger | null

Non-current assets (固定資産) in JPY.

ppeinteger | null

Property, plant and equipment (有形固定資産) in JPY.

intangible_assetsinteger | null

Intangible assets (無形固定資産) in JPY.

inventoriesinteger | null

Inventories (棚卸資産) in JPY.

trade_receivablesinteger | null

Trade receivables (売掛金・受取手形) in JPY.

current_liabilitiesinteger | null

Current liabilities (流動負債) in JPY.

noncurrent_liabilitiesinteger | null

Non-current liabilities (固定負債) in JPY.

trade_payablesinteger | null

Trade payables (買掛金・支払手形) in JPY.

ibd_currentinteger | null

Interest-bearing debt, current portion in JPY. Short-term borrowings + current LT debt.

ibd_noncurrentinteger | null

Interest-bearing debt, non-current in JPY. Long-term borrowings + bonds payable.

retained_earningsinteger | null

Retained earnings (利益剰余金) in JPY.

non_controlling_interestsinteger | null

Non-controlling interests (非支配株主持分) in JPY.

capexinteger | null

Capital expenditure in JPY. From investing CF.

treasury_stockinteger | null

Treasury stock (自己株式) in JPY. Reported as negative in equity section.

goodwillinteger | null

Goodwill (のれん) in JPY. IFRS: separate line; JP-GAAP: in intangibles.

interest_expenseinteger | null

Interest expense (支払利息) in JPY.

investment_securitiesinteger | null

Investment securities (投資有価証券) in JPY.

deferred_tax_assetsinteger | null

Deferred tax assets (繰延税金資産) in JPY.

is_consolidatedboolean

True for consolidated financials. False for standalone/parent-only filers.

default true

accounting_standardstring | null

Accounting standard: 'JP-GAAP', 'IFRS', or 'US-GAAP'. Null when not resolved from filing metadata.

currencystring

Currency code. Always 'JPY'. All monetary values are in Japanese yen.

default JPY

source_doc_idstring | null

EDINET document ID of the source filing (e.g. 'S100ABCD').

data_sourcestring

Data provenance.

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

Return on assets (%). net_income ÷ total_assets × 100.

operating_marginnumber | null

Operating margin (%). operating_income ÷ revenue × 100.

net_marginnumber | null

Net margin (%). net_income ÷ revenue × 100.

gross_marginnumber | null

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

equity_rationumber | null

Equity ratio (%). total_equity ÷ total_assets × 100.

Errors

Standard HTTP status codes plus a typed error.code in the { error: { code, message } } envelope.

Every endpoint returns the same typed error envelope ({ error: { code, message } }). For the full list of codes, see the Errors reference.

RequestcURL

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

Response · 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"
  }
}

Response · 401

401 UNAUTHORIZED

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