Get free API key
All APIsexpand_more
search
appsAll APIs
functionHow metrics are calculated

Annual report XBRL facts

GET/stable/financial-facts10 tokens per callNew

Returns raw XBRL facts tagged in the latest (or a specified) annual securities report, one row per element and context, with Japanese and English labels, dimension members and numeric or text values. Filter by category and by a case-insensitive part of the element name (tag). Up to 2,000 facts per call. Ratios are 0–1 decimals (0.1 = 10%).

What you can do with this API

  • check_circlePull a specific item such as total assets directly by its tag name
  • check_circleLook up note figures that are not in standard statement endpoints
  • check_circleFetch all balance sheet items for your own analysis

Example URL

https://api.zenithcode.net/stable/financial-facts?symbol=7203&fiscalPeriod=2026-03&category=Balance_Sheet&tag=TotalAssets&limit=500

Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.

Parameters

ParameterRequiredDescriptionExample
symbol
string
RequiredSecurities code (4 characters, e.g. 7203 = Toyota Motor; alphanumeric codes such as 130A also work)7203
fiscalPeriod
string
OptionalFiscal period (YYYY-MM, e.g. 2026-03). Defaults to the latest annual securities report2026-03
category
select
OptionalCategory (Balance_Sheet, Income_Statement, Comprehensive_Income, Cash_Flow, Changes_In_Equity, Notes_and_Other, Notes_and_Other_Meta). Omit for all
Allowed values: Balance_Sheet, Income_Statement, Comprehensive_Income, Cash_Flow, Changes_In_Equity, Notes_and_Other, Notes_and_Other_Meta
Balance_Sheet
tag
string
OptionalPart of the element name (case-insensitive)TotalAssets
limit
number
OptionalMaximum number of rows to return (default 500, max 2,000)500

Try it

Run it with your own parameters and check the response as a table, JSON or CSV. Sign-in required; each run uses 10 tokens.

travel_exploreTry in the API Viewer

Response example (real data)

lock
Live response examples are shown to signed-in users only (they include exchange data such as stock prices). Sign in to view

Response fields

symbolstring
fiscalPeriodstring
periodstring
docIdstring
docTypeCodestring
submittedAtstring
sourceUrlEDINET原本へのリンクstringEDINET原本へのリンク
truncatedlimit で打ち切った場合 truebooleanlimit で打ち切った場合 true
factsarray

Related APIs

FAQ

How do I narrow down the result?expand_more

Pick a category first (e.g. Balance_Sheet), then put part of an element name such as TotalAssets in tag to get only the rows you need.

How many tokens does one call use?expand_more

10 tokens per call, regardless of how many rows come back. Your monthly allowance depends on your plan.

Do I need an account to try it?expand_more

Use the API Viewer to run it with your own parameters. Sign up for free and sign in (no credit card). Each run uses this API's tokens.

Can I get CSV instead of JSON?expand_more

Add format=csv to the URL to get CSV, ready for spreadsheets or pandas.

Can I get labels in English?expand_more

With neither lang nor Accept-Language, labels such as sector names are returned in English; add lang=ja or send Accept-Language: ja for Japanese. Company and sector names are always returned in both languages as nameJa / nameEn and sectorJa / sectorEn. Field names are the same in both languages.