Skip to main content
Japan Financials provides the financial facts a Japanese-listed company tagged in its own filings: the annual securities report (有価証券報告書) and half-year report (半期報告書) filed to EDINET, the Financial Services Agency’s filing system, and the earnings release (決算短信) filed to TDnet, the Tokyo Stock Exchange’s timely-disclosure network. Each row is one tagged fact for one period, with a link to the filing it came from. Every response also carries a metrics block with derived ratios for the company’s latest period.
Plan: Free and above · Credits: 1 per call

​
What you can use Japan financials for

Read a Japanese company’s accounts as it actually tagged them, including its five-year key-indicator table. Get a Japanese quarter, which since 2024 exists only in the TDnet earnings release. Trace any figure back to the original EDINET or TDnet document. Read the latest-period margins, returns and liquidity ratios without computing them yourself.

​
These are the filer’s own facts, not a normalised statement

There is no revenue field. Which element is revenue differs by accounting standard and by filer: Toyota tags SalesRevenuesIFRS, Sony NetSalesIFRS, a Japanese-GAAP industrial NetSales, a bank OrdinaryIncomeBNK.Match on element_id, using the element parameter as a substring search. label_ja is the filer’s own Japanese label and is not reliable to match on.
element_id keeps its namespace prefix, and the prefix tells you what you are holding: A company-specific prefix (for example jpcrp030000-asr_E02144-000:) marks an element the filer defined itself.

​
Two sources, and source says which

  • edinet — the statutory annual and half-year reports, plus quarterly reports filed before the quarterly report was abolished in 2024. EDINET has carried no quarters since 2024.
  • tdnet — the company’s own earnings release. This is the only place a recent Japanese quarter exists.
Both come back by default; pass source to keep one.
TDnet values are cumulative from the start of the fiscal year, not the quarter alone: a second-quarter release prints the first six months. period_grain says which (3M, 6M, 9M or FY) and is null on EDINET rows. Subtract two grains to get a single quarter, and never compare a 6M figure with a 3M one.
report_period maps to both sources: annual is the annual report or full-year release, half the half-year report or second-quarter release, and quarterly a pre-2024 quarterly report or a first- or third-quarter release.

​
Consolidated, parent-only and other

basis follows the taxonomy a fact was tagged in, not the accounts it describes. Only the Japanese-GAAP statement taxonomy (jppfs_cor:) marks consolidated versus parent-only.
An IFRS filer tags its statements in jpigp_cor:, which carries no consolidation mark, so those rows come back with basis other. Filtering on basis=consolidated returns nothing for Sony’s or Toyota’s consolidated revenue. For an IFRS filer, read the jpigp_cor: elements, which are the consolidated accounts by construction; its jppfs_cor: rows are the parent-only ones.
On EDINET rows basis is returned as Consolidated, NonConsolidated or Other; on TDnet rows it is consolidated or non_consolidated. The filter parameter takes the lowercase form for both. The key indicators (経営指標等, jpcrp_cor:…SummaryOfBusinessResults) appear twice per year under the same element_id: the bare context (context_id such as CurrentYearDuration) is the consolidated figure, and …_NonConsolidatedMember is the parent-only one. A context_id ending in a …ReportableSegmentMember is that segment’s figure, not the group’s. Read context_id before taking a value.

​
Key Japan financial fields

  • value_num holds a numeric fact and value_text anything untagged as a number; there is no combined value column.
  • unit is the currency or unit of the row — usually JPY, but a filer can tag the same fact in more than one currency, so read it before comparing.
  • rel_period is the filing’s own word for which period a fact belongs to: 当期 (current), 前期 (prior), up to 四期前 (four years back). One annual report carries five years of key indicators, so one call gives history. A duration and an instant use different words — 当期 is the year, 当期末 its closing date — and is_point_in_time says which kind a row is. TDnet rows use English values such as current.
  • doc_id, doc_description, filed_on and filing_url identify the source document. accounting_standard is set on TDnet rows.
Japanese-GAAP ResearchAndDevelopmentExpensesSGA is already inside SG&A — a breakdown line, not an addition to it.

​
Amendments

An amended report (訂正報告書) restates figures. By default you get the corrected value; pass include_superseded=true to see the original as well.

​
The metrics block

Every response carries a top-level metrics object with derived figures for the company’s latest period: liquidity (current_ratio, quick_ratio, cash_ratio, operating_cash_flow_ratio), efficiency, leverage and coverage, margins, returns and year-on-year growth. These are the same numbers the company screen filters and sorts on.
  • metrics.period says which period it describes. It does not follow the year, period_end or report_period filters on the rows beside it.
  • metrics.amounts are in whole units of metrics.currency (unit: "ones"), which is not always the scale of the statement rows.
  • metrics.ratios are fractions (0.2 = 20%), except days_sales_outstanding and operating_cycle, which are days.
  • A null field means the input is not published for this market; metrics: null means FocusAlpha holds no fundamentals for the company at all.

​
Japan financials coverage

About 3,800 Japanese-listed companies. Every response carries a measured coverage block: available_from and available_to are the earliest and latest filing loaded, companies_covered is how many companies have facts, and companies_tracked is the Japanese universe they are measured against. Older years are still being added, so read coverage.available_from rather than assuming a start year. history_status reads all_tracked_filers_loaded, backfill_in_progress_majority_loaded or largest_cap_first_backfill_in_progress; while a backfill is in progress, a missing smaller company means not yet loaded, not not filed. There is no forward guidance here: EDINET filings carry no earnings forecast, and the forecast half of the earnings release is served by Management Guidance.

​
GET /v1/companies/{company}/jp/financials

​
string
required
Tokyo symbol (6758.T or 6758), five-digit EDINET security code (67580), EDINET filer code (E01777), ADR symbol (SONY), ISIN or company_id.
​
string
default:"all"
edinet, tdnet or all.
​
string
annual, half or quarterly.
​
string
consolidated, non_consolidated or other. other returns EDINET rows only.
​
string
Substring of element_id, e.g. NetSales, OperatingIncome, Assets.
​
integer
Calendar year of the period end, between 2000 and 2100.
​
string
Exact period end, YYYY-MM-DD.
​
string
default:"false"
true also returns figures a later amendment restated.
​
integer
default:"200"
Rows per page, between 1 and 1000. Rows are ordered newest period first; page through with cursor, passing back next_cursor unchanged.
See also Japan Segments for the business-segment breakdown, Japan Report Sections for the annual report’s narrative, Japan TDnet Disclosures for the earnings releases themselves, and Management Guidance for Japanese forecasts.