--- title: "Get Company" method: GET path: "/v1/companies/{code}" tags: ["companies"] --- # Get Company `GET /v1/companies/{code}` ## Path parameters - `code` string, required ## Query parameters - `expand` string, nullable — Comma-separated sub-resources to include: financials, ratios, growth, peers, segments, translations, health_score. Use 'all' for everything. - `years` integer - `peer_limit` integer — Max peers to return (default 10) ## Response `200` Successful Response - SingleResponseCompanyExpandedOut - `data` CompanyExpandedOut, required — Company with optional expanded sub-resources. - `edinet_code` string, required — EDINET submitter code assigned by FSA (e.g. 'E02144'). Primary identifier. - `securities_code` string, nullable — TSE securities code, 4 digits (e.g. '7203'). - `name_jp` string, required — Company name in Japanese (e.g. 'トヨタ自動車株式会社'). - `name_en` string, nullable — Company name in English. Null if not provided in filings. - `sector` string, nullable — TSE 33-sector classification in Japanese (e.g. '輸送用機器'). - `sector_en` string, nullable — TSE 33-sector in English. Auto-translated. - `fiscal_year_end` string, nullable — Fiscal year-end month as 2-digit string (e.g. '03' for March). - `listing` string, nullable — TSE market segment in Japanese (e.g. 'プライム（内国株式）'). - `listing_en` string, nullable — TSE market segment in English (e.g. 'Prime'). Auto-translated from listing. - `created_at` string, date-time, required — When this company record was first created in Axiora. - `updated_at` string, date-time, required — When this company record was last updated. - `financials` FinancialOut[], nullable — Financial data for this company (when expand=financials). - `edinet_code` string, required — EDINET submitter code (e.g. 'E02144'). - `fiscal_year` integer, required — Fiscal year label. '2024' means the fiscal year ending in calendar year 2024. - `period_end` string, date, required — Last day of the fiscal period (e.g. '2024-03-31'). - `revenue` integer, nullable — Revenue (売上高) in JPY. IFRS: Revenue; JP-GAAP: 売上高 or 営業収益. - `net_income` integer, nullable — Net income attributable to owners of the parent in JPY. Null if not reported. - `operating_income` integer, nullable — Operating income (営業利益) in JPY. - `ordinary_income` integer, nullable — Ordinary income (経常利益) in JPY. JP-GAAP only; includes non-operating items. - `total_assets` integer, nullable — Total assets (総資産) in JPY. - `total_equity` integer, nullable — Total equity including non-controlling interests in JPY. - `net_assets` integer, nullable — Net assets (純資産) in JPY. JP-GAAP concept; includes NCI and stock acquisition rights. - `total_liabilities` integer, nullable — Total liabilities (負債合計) in JPY. - `cash_and_equivalents` integer, nullable — Cash and cash equivalents in JPY. BS item, not CF ending balance. - `operating_cf` integer, nullable — Cash flow from operating activities in JPY. - `investing_cf` integer, nullable — Investing cash flow in JPY. Typically negative. - `financing_cf` integer, nullable — Financing cash flow in JPY. Negative = net repayment. - `eps` number, nullable — Basic EPS in JPY (e.g. 285.23). - `diluted_eps` number, nullable — Diluted EPS in JPY. Adjusts for convertibles/options. - `dividends_per_share` number, nullable — Annual DPS in JPY (e.g. 75.0). Interim + year-end. - `bps` number, nullable — Book value per share in JPY. - `roe` number, nullable — Return on equity (%). E.g. 12.5 means 12.5%. - `pe_ratio` number, nullable — Price-to-earnings ratio. Derived from market price ÷ EPS when available. - `num_employees` integer, nullable — Number of employees (headcount). Unitless integer. - `payout_ratio` number, nullable — Payout ratio (%). E.g. 30.0 = 30%. Dividends / NI. - `capital_stock` integer, nullable — Stated capital (資本金) in JPY. - `comprehensive_income` integer, nullable — Comprehensive income in JPY. Net income + OCI. - `income_before_tax` integer, nullable — Income before income taxes (税引前当期純利益) in JPY. - `shares_issued` integer, nullable — Total shares issued (発行済株式総数). Includes treasury stock. - `shares_outstanding_at_filing` integer, nullable — Shares outstanding at filing date (提出日現在の発行済株式総数). DEI header. - `interim_dividend` number, nullable — Interim dividend per share in JPY. Subset of dividends_per_share. - `cost_of_sales` integer, nullable — Cost of sales (売上原価) in JPY. - `gross_profit` integer, nullable — Gross profit (売上総利益) in JPY. Revenue minus cost of sales. - `sga` integer, nullable — Selling, general and administrative expenses (販管費) in JPY. - `extraordinary_income` integer, nullable — Extraordinary income (特別利益) in JPY. JP-GAAP only. - `extraordinary_loss` integer, nullable — Extraordinary loss (特別損失) in JPY. JP-GAAP only. - `depreciation` integer, nullable — Depreciation and amortization in JPY. - `rnd_expenses` integer, nullable — R&D expenses (研究開発費) in JPY. - `current_assets` integer, nullable — Current assets (流動資産) in JPY. - `noncurrent_assets` integer, nullable — Non-current assets (固定資産) in JPY. - `ppe` integer, nullable — Property, plant and equipment (有形固定資産) in JPY. - `intangible_assets` integer, nullable — Intangible assets (無形固定資産) in JPY. - `inventories` integer, nullable — Inventories (棚卸資産) in JPY. - `trade_receivables` integer, nullable — Trade receivables (売掛金・受取手形) in JPY. - `current_liabilities` integer, nullable — Current liabilities (流動負債) in JPY. - `noncurrent_liabilities` integer, nullable — Non-current liabilities (固定負債) in JPY. - `trade_payables` integer, nullable — Trade payables (買掛金・支払手形) in JPY. - `ibd_current` integer, nullable — Interest-bearing debt, current portion in JPY. Short-term borrowings + current LT debt. - `ibd_noncurrent` integer, nullable — Interest-bearing debt, non-current in JPY. Long-term borrowings + bonds payable. - `retained_earnings` integer, nullable — Retained earnings (利益剰余金) in JPY. - `non_controlling_interests` integer, nullable — Non-controlling interests (非支配株主持分) in JPY. - `capex` integer, nullable — Capital expenditure in JPY. From investing CF. - `treasury_stock` integer, nullable — Treasury stock (自己株式) in JPY. Reported as negative in equity section. - `goodwill` integer, nullable — Goodwill (のれん) in JPY. IFRS: separate line; JP-GAAP: in intangibles. - `interest_expense` integer, nullable — Interest expense (支払利息) in JPY. - `investment_securities` integer, nullable — Investment securities (投資有価証券) in JPY. - `deferred_tax_assets` integer, nullable — Deferred tax assets (繰延税金資産) in JPY. - `is_consolidated` boolean — True for consolidated financials. False for standalone/parent-only filers. - `currency` string — Currency code. Always 'JPY' — all monetary values are in Japanese yen. - `source_doc_id` string, nullable — EDINET document ID of the source filing (e.g. 'S100ABCD'). - `data_source` string — Data provenance. - `ratios` RatioOut[], nullable — Computed ratios (when expand=ratios). - `fiscal_year` integer, required — Fiscal year. - `period_end` string, nullable — Last day of the fiscal period (ISO 8601). - `roe` number, nullable — Return on equity (%). Net income ÷ average equity. - `roa` number, nullable — Return on assets (%). Net income ÷ average total assets. - `operating_margin` number, nullable — Operating margin (%). Operating income ÷ revenue. - `net_margin` number, nullable — Net margin (%). Net income ÷ revenue. - `gross_margin` number, nullable — Gross margin (%). Gross profit ÷ revenue. - `equity_ratio` number, nullable — Equity ratio (%). Total equity ÷ total assets. - `debt_to_equity` number, nullable — Debt-to-equity ratio. Total liabilities ÷ total equity. - `current_ratio` number, nullable — Current ratio. Current assets / current liabilities. - `interest_coverage` number, nullable — Interest coverage ratio. Operating income ÷ interest expense. - `pe_ratio` number, nullable — Price-to-earnings ratio. - `num_employees` integer, nullable — Number of employees (headcount). - `eps` number, nullable — Basic earnings per share in JPY. - `bps` number, nullable — Book value per share in JPY. - `dividends_per_share` number, nullable — Annual dividends per share in JPY. - `payout_ratio` number, nullable — Dividend payout ratio (%). - `growth` GrowthOut - `yoy` YoyEntry[], required — Year-over-year growth rates for each fiscal year. - `fiscal_year` integer, required — Fiscal year. - `period_end` string, nullable — Last day of the fiscal period (ISO 8601). - `growth` GrowthMetrics, required - `revenue` number, nullable — Revenue growth rate (%). Positive means growth. - `gross_profit` number, nullable — Gross profit growth rate (%). - `net_income` number, nullable — Net income growth rate (%). - `operating_income` number, nullable — Operating income growth rate (%). - `eps` number, nullable — EPS growth rate (%). - `total_assets` number, nullable — Total assets growth rate (%). - `cagr` CagrOut, required - `3yr` GrowthMetrics - `revenue` number, nullable — Revenue growth rate (%). Positive means growth. - `gross_profit` number, nullable — Gross profit growth rate (%). - `net_income` number, nullable — Net income growth rate (%). - `operating_income` number, nullable — Operating income growth rate (%). - `eps` number, nullable — EPS growth rate (%). - `total_assets` number, nullable — Total assets growth rate (%). - `5yr` GrowthMetrics - `revenue` number, nullable — Revenue growth rate (%). Positive means growth. - `gross_profit` number, nullable — Gross profit growth rate (%). - `net_income` number, nullable — Net income growth rate (%). - `operating_income` number, nullable — Operating income growth rate (%). - `eps` number, nullable — EPS growth rate (%). - `total_assets` number, nullable — Total assets growth rate (%). - `peers` PeerOut[], nullable — Peer companies (when expand=peers). - `company` CompanyOut, required - `edinet_code` string, required — EDINET submitter code assigned by FSA (e.g. 'E02144'). Primary identifier. - `securities_code` string, nullable — TSE securities code, 4 digits (e.g. '7203'). - `name_jp` string, required — Company name in Japanese (e.g. 'トヨタ自動車株式会社'). - `name_en` string, nullable — Company name in English. Null if not provided in filings. - `sector` string, nullable — TSE 33-sector classification in Japanese (e.g. '輸送用機器'). - `sector_en` string, nullable — TSE 33-sector in English. Auto-translated. - `fiscal_year_end` string, nullable — Fiscal year-end month as 2-digit string (e.g. '03' for March). - `listing` string, nullable — TSE market segment in Japanese (e.g. 'プライム（内国株式）'). - `listing_en` string, nullable — TSE market segment in English (e.g. 'Prime'). Auto-translated from listing. - `created_at` string, date-time, required — When this company record was first created in Axiora. - `updated_at` string, date-time, required — When this company record was last updated. - `fiscal_year` integer, required — Fiscal year of the peer data. - `revenue` integer, nullable — Revenue in JPY. - `net_income` integer, nullable — Net income in JPY. - `segments` object[], nullable — Business segment data (when expand=segments). - `translations` TranslationOut[], nullable — English translations (when expand=translations). - `section` string, required — Section key: mda, risk_factors, business_overview, governance, financial_notes, or accounting_policy. - `source_jp` string, nullable — Original Japanese text. Null if source was not stored. - `text_en` string, nullable — English translation of the section. Null if not yet translated. - `model` string, nullable — LLM model used for translation (e.g. 'gemini/gemini-2.0-flash'). - `token_count` integer, nullable — Approximate token count of the translated output. - `translated_at` string, date-time, required — When the translation was generated. - `health_score` HealthScoreOut - `edinet_code` string, required — EDINET submitter code. - `score` integer, required — Financial health score from 0 to 100. Higher is healthier. - `components` object, required — Score breakdown by component (stability, profitability, cash_flow). - `flags` string[], required — Risk flags (e.g. net_loss, negative_operating_cf). - `industry_adjustment` number, required — Industry adjustment points (-5 to +5) vs sector medians. - `fiscal_year` integer, required — Fiscal year the score is based on. - `computed_at` string, date-time, required — When the score was computed. - `data_source` string — Data provenance. - `methodology` string — Human-readable summary of the scoring methodology. - `meta` Meta, required - `total` integer, nullable — Total number of matching records (list endpoints only). - `limit` integer, nullable — Maximum records returned per page. - `offset` integer, nullable — Number of records skipped (offset-based pagination). - `next_cursor` string, nullable — Opaque cursor for the next page (keyset pagination). Null on the last page. - `request_id` string, required — Unique request identifier for tracing and support (e.g. 'req_abc123'). ## Other responses - `422` — Validation Error --- [API](https://skmtc.net/axioradev/apis/axiora-api.md) · [All operations](https://skmtc.net/axioradev/apis/axiora-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/axioradev/axiora-api/revisions/b8bf48556541/schema)