Docs/Reference/Companies/Get Ratios
GET/v1/companies/{code}/ratiosTier · Free

Get Ratios

Computed financial ratios for a company over time.

These are derived numbers, not filed ones. meta.data_as_of reports the freshness of the EDINET ingest they were computed from.

Path parameters · 1

Variables interpolated into the URL path.

codestringrequired

Query parameters · 2

Optional filters and modifiers. Pass as URL-encoded ?key=value.

yearsintegeroptional
default 5
split_adjustedbooleanoptional

Adjust per-share values (EPS, BPS, DPS) for detected stock splits so the time-series is comparable. Set to false for raw unadjusted values.

default true

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

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

Envelope

dataRatioOut[]

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>

RatioOut

fiscal_yearinteger

Fiscal year.

period_endstring | null

Last day of the fiscal period (ISO 8601).

roenumber | null

Return on equity (%). Net income ÷ average equity.

roanumber | null

Return on assets (%). Net income ÷ average total assets.

operating_marginnumber | null

Operating margin (%). Operating income ÷ revenue.

net_marginnumber | null

Net margin (%). Net income ÷ revenue.

gross_marginnumber | null

Gross margin (%). Gross profit ÷ revenue.

equity_rationumber | null

Equity ratio (%). Total equity ÷ total assets.

debt_to_equitynumber | null

Debt-to-equity ratio. Total liabilities ÷ total equity.

current_rationumber | null

Current ratio. Current assets / current liabilities.

interest_coveragenumber | null

Interest coverage ratio. Operating income ÷ interest expense.

pe_rationumber | null

Price-to-earnings ratio.

num_employeesinteger | null

Number of employees (headcount).

epsnumber | null

Basic earnings per share in JPY.

bpsnumber | null

Book value per share in JPY.

dividends_per_sharenumber | null

Annual dividends per share in JPY.

payout_rationumber | null

Dividend payout ratio (%).

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.