Docs/Reference/Companies/Search Companies
GET/v1/companies/searchTier · Free

Search Companies

Search companies by name, securities code, or EDINET code.

Returns results ranked by match quality: exact code matches first, then prefix matches, then substring matches.

Query parameters · 2

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

qstringrequired

Search query

limitintegeroptional
default 20

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

The standard { data, meta } envelope. data contains an array of CompanyOut.

Envelope

dataCompanyOut[]

Array of result objects.

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>

CompanyOut

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

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.