---
title: "Search Companies"
method: GET
path: "/v1/companies/search"
tags: ["companies"]
---

# Search Companies

`GET /v1/companies/search`

## Request

- Base URL: `https://api.axiora.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.axiora.dev/v1/companies/search`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/axioradev/apis/axiora-api/docs/v1/companies/search/get.ts> (a function with typed inputs; its response is checked against the schema)

Search companies by name, former name, securities code, EDINET code, or
13-digit corporate number (法人番号).

Returns results ranked by match quality: exact code matches first,
then prefix matches, then substring matches. A company that renamed is
found by its former names too; each result lists them in `former_names`.

## Query parameters

- `q` string, required: Search query
- `limit` integer

## Response `200`

Successful Response

- ListResponseCompanySearchOut
  - `data` CompanySearchOut[], required: Array of result objects.
    - `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.
    - `name_en_quality` string, nullable: 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_at` string, date-time, nullable: Timestamp `name_en` was last resolved. Use to detect staleness.
    - `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.
    - `sector_display` string: 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`.
    - `entity_type` string, nullable: Entity classification: 'listed_company', 'fund', or 'unlisted_filer'.
    - `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.
    - `former_names` CompanyFormerNameOut[]: Legal names this company held before its current one, most recent first. Holdings, filings and partner records dated before a rename carry these names. Empty when no former name is recorded.
      - `name_jp` string, required: Former name in Japanese.
      - `name_en` string, nullable: Former name in English, if known.
  - `meta` AxioraApiSchemasMeta, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `996d12eb9cb3`: 1 breaking, 4 warning, 5 info
  - removed the required property `meta/request_id` from the response with the `200` status
  - removed the optional property `meta/limit` from the response with the `200` status
  - removed the optional property `meta/next_cursor` from the response with the `200` status
  - removed the optional property `meta/offset` from the response with the `200` status
  - …6 more

[Operation history](https://skmtc.dev/axioradev/apis/axiora-api/changes/v1/companies/search/get.md)

---

[API](https://skmtc.dev/axioradev/apis/axiora-api.md) - [All operations](https://skmtc.dev/axioradev/apis/axiora-api/llms.txt) - [OpenAPI document](https://skmtc.dev/axioradev/apis/axiora-api/revisions/47e27a7f92de?raw)