{"openapi":"3.2.0","info":{"title":"EDINET Japan Financials API","description":"Financial statements (P/L, B/S, C/F) of 3,634 Japanese listed companies from official EDINET filings, normalized across J-GAAP, IFRS, and US GAAP with English keys. This API no longer receives data updates. Equivalent normalized EDINET data is available for free at edinetdb.jp - please use that instead. No new subscriptions are recommended.","version":"1.0.0"},"servers":[{"url":"https://oomih.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"api"}],"x-agent-commerce":{"catalog_url":"https://oomih.jojapi.net/_jojapi/agent/plans","discovery_url":"https://oomih.jojapi.net/.well-known/x402","directory_url":"https://agents.jojapi.net/apis/edinet-japan-financials-api","docs":"https://docs.jojapi.com/consumers/agents"},"paths":{"/api/companies/index.json":{"get":{"operationId":"get_api_companies_index_json","summary":"listCompanies","description":"Returns the full directory of covered companies (3,600+), including securities code, English/Japanese names, industry, accounting standard, fiscal period and source document metadata. Use the `sec_code` values to call the per-company endpoint.","tags":["api"],"responses":{"200":{"description":"Company directory","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"source":{"type":"object","description":"EDINET attribution required by the source terms of use","properties":{"provider":{"type":"string"},"attribution":{"type":"string"}}},"selection":{"type":"object","description":"How the company universe was selected"},"counts":{"type":"object","description":"Coverage counters (succeeded / failed / total)"},"companies":{"type":"array","items":{"type":"object","properties":{"sec_code":{"type":"string"},"name_en":{"type":"string"},"name_ja":{"type":"string"},"industry":{"type":"string","description":"Industry label (Japanese, EDINET taxonomy)"},"accounting_standard":{"type":"string","description":"Japanese GAAP / IFRS / US GAAP"},"fiscal_period":{"type":"object","properties":{"start":{"type":"string","format":"date"},"end":{"type":"string","format":"date"}}},"doc_id":{"type":"string","description":"EDINET document id of the source filing"},"submit_date":{"type":"string"}}}},"failures":{"type":"array","description":"Companies whose latest filing could not be normalized","items":{"type":"object"}}}},"examples":{"Example_1":{"value":{"schema_version":"edinet-companies-index-0.1","generated_at":"","source":{"provider":"","attribution":""},"selection":{},"counts":{},"companies":[{"sec_code":"7203","name_en":"TOYOTA MOTOR CORPORATION","name_ja":"","industry":"","accounting_standard":"IFRS","fiscal_period":{"start":"","end":""},"doc_id":"","submit_date":""}],"failures":[]}}}}}}}}},"/api/companies/{code}.json":{"get":{"operationId":"get_api_companies_code_json","summary":"getCompanyFinancials","description":"Returns the latest annual figures for one company identified by its securities code (e.g. `7203` for Toyota; alphanumeric codes such as `130A` also exist). Includes income statement, balance sheet and cash-flow statement with stable English keys, plus an explicit `unavailable` list for items that do not exist under the company's accounting standard.","tags":["api"],"responses":{"200":{"description":"Normalized financial statements","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"source":{"type":"object","description":"EDINET attribution required by the source terms of use","properties":{"provider":{"type":"string"},"attribution":{"type":"string"}}},"company":{"type":"object","properties":{"sec_code":{"type":"string"},"edinet_code":{"type":"string"},"name_ja":{"type":"string"},"name_en":{"type":"string"}}},"fiscal_year":{"type":"object","properties":{"period_start":{"type":"string","format":"date"},"period_end":{"type":"string","format":"date"},"accounting_standard":{"type":"string"},"consolidation":{"type":"string"},"currency":{"type":"string"}}},"unit":{"type":"string"},"financials":{"type":"object","description":"Three statements keyed by stable English item keys (e.g. revenue, operating_income, total_assets, cash_flow_from_operations).","properties":{"income_statement":{"type":"object","description":"Map of English item key to a normalized figure","additionalProperties":{"type":"object","properties":{"value":{"type":"number","description":"Absolute yen (not thousands/millions)"},"unit":{"type":"string"},"context":{"type":"string","description":"duration (flow) or instant (stock)"},"element_id":{"type":"string","description":"Source XBRL element id (audit trail)"},"item_name_ja":{"type":"string","description":"Original Japanese caption when available"}}}},"balance_sheet":{"type":"object","description":"Map of English item key to a normalized figure","additionalProperties":{"type":"object","properties":{"value":{"type":"number","description":"Absolute yen (not thousands/millions)"},"unit":{"type":"string"},"context":{"type":"string","description":"duration (flow) or instant (stock)"},"element_id":{"type":"string","description":"Source XBRL element id (audit trail)"},"item_name_ja":{"type":"string","description":"Original Japanese caption when available"}}}},"cash_flow_statement":{"type":"object","description":"Map of English item key to a normalized figure","additionalProperties":{"type":"object","properties":{"value":{"type":"number","description":"Absolute yen (not thousands/millions)"},"unit":{"type":"string"},"context":{"type":"string","description":"duration (flow) or instant (stock)"},"element_id":{"type":"string","description":"Source XBRL element id (audit trail)"},"item_name_ja":{"type":"string","description":"Original Japanese caption when available"}}}}}},"items_count":{"type":"integer"},"unavailable":{"type":"array","description":"Items that do not exist for this company, with the reason (e.g. ordinary_income is a Japanese-GAAP-only concept and is absent under IFRS). Explicit instead of silently missing.","items":{"type":"object","properties":{"key":{"type":"string"},"statement":{"type":"string"},"basis":{"type":"string"},"reason":{"type":"string"}}}}}},"examples":{"Example_1":{"value":{"schema_version":"","generated_at":"","source":{"provider":"","attribution":""},"company":{"sec_code":"7203","edinet_code":"E02144","name_ja":"","name_en":""},"fiscal_year":{"period_start":"","period_end":"","accounting_standard":"IFRS","consolidation":"consolidated","currency":"JPY"},"unit":"JPY (absolute yen)","financials":{"income_statement":{},"balance_sheet":{},"cash_flow_statement":{}},"items_count":0,"unavailable":[{"key":"ordinary_income","statement":"income_statement","basis":"jgaap_only","reason":""}]}}}}}},"404":{"description":"Unknown securities code","content":{"application/json":{"examples":{"Example_1":{"value":{}}}}}}},"parameters":[{"name":"code","in":"path","description":"Securities code (4-5 alphanumeric characters), e.g. 7203","required":true,"schema":{"type":"string","example":"7203"}}]}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}