Docs/Reference/Companies/Get Company
GET/v1/companies/{code}Tier · Free

Get Company

One company by code (EDINET or securities), optionally expanded.

Returns the company's identifiers, sector, listing, and English- name audit fields. Pass expand= to inline sub-resources in a single round-trip: supported: financials, ratios, growth, peers, segments, translations, health_score. Use expand=all to grab everything.

Path parameters · 1

Variables interpolated into the URL path.

codestringrequired

Query parameters · 3

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

expandstring | nulloptional

Comma-separated sub-resources to include: financials, ratios, growth, peers, segments, translations, health_score. Use 'all' for everything.

yearsintegeroptional
default 5
peer_limitintegeroptional

Max peers to return (default 10)

default 10

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

The standard { data, meta } envelope. data contains CompanyExpandedOut.

Envelope

dataCompanyExpandedOut

A single result object.

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>

CompanyExpandedOut

edinet_codestring

EDINET submitter code assigned by FSA (e.g. 'E02144'). Primary identifier.

securities_codestring | null

TSE securities code, 4 digits (e.g. '7203').

name_jpstring

Company name in Japanese (e.g. 'トヨタ自動車株式会社').

name_enstring | null

Company name in English. Null if not provided in filings.

name_en_qualitystring | null

Audit tag for name_en. One of: 'verified' (from an authoritative external registry), 'derived' (deterministic extraction or high-confidence public-registry match), 'machine' (model-generated, lowest confidence). Null when no English name has been resolved yet.

name_en_resolved_atstring · date-time | null

Timestamp name_en was last resolved. Use to detect staleness.

format date-time
sectorstring | null

TSE 33-sector classification in Japanese (e.g. '輸送用機器').

sector_enstring | null

TSE 33-sector in English. Auto-translated.

fiscal_year_endstring | null

Fiscal year-end month as 2-digit string (e.g. '03' for March).

listingstring | null

TSE market segment in Japanese (e.g. 'プライム（内国株式）').

listing_enstring | null

TSE market segment in English (e.g. 'Prime'). Auto-translated from listing.

sector_displaystring

Always-populated display label derived from sector + listing. TSE's 33-sector classification only applies to listed equities; unlisted filers (REITs, asset managers, foreign subs) carry no sector. This field surfaces that gap explicitly: 'Unlisted' when listing is null, 'Uncategorised' when listed but unclassified, otherwise the English sector name. Consumers needing the raw TSE classification should still read sector / sector_en.

default
entity_typestring | null

Entity classification: 'listed_company', 'fund', or 'unlisted_filer'.

created_atstring · date-time

When this company record was first created in Axiora.

format date-time
updated_atstring · date-time

When this company record was last updated.

format date-time
financialsFinancialOut[] | null

Financial data for this company (when expand=financials).

ratiosRatioOut[] | null

Computed ratios (when expand=ratios).

growthGrowthOut | null

Growth rates and CAGRs (when expand=growth).

peersPeerOut[] | null

Peer companies (when expand=peers).

segmentsobject[] | null

Business segment data (when expand=segments).

translationsTranslationOut[] | null

English translations (when expand=translations).

health_scoreHealthScoreOut | null

Financial health score (when expand=health_score).

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.