---
title: "Find corporate numbers by name / 法人の名前から法人番号"
method: GET
path: "/v1/corporations/search"
---

# Find corporate numbers by name / 法人の名前から法人番号

`GET /v1/corporations/search`

## Request

- Base URL: `https://biz.ossalt.jp`
- URL: `https://biz.ossalt.jp/v1/corporations/search`
- Auth: none declared

Find Japanese corporations whose name starts with the given text (prefix match), in the National Tax Agency's monthly bulk data. Legal-form words such as 株式会社 or 一般社団法人 are ignored at either end, and full/half-width and spaces are normalized. Matching in the middle of a name and furigana search are not supported. flags: `truncated`, `exact_match_only` (too many names start with the input; only exact matches returned), `not_found`. Returns up to 100 matches (`total`, `returned`, `truncated`) with corporate number, name, prefecture, city and `is_closed` (registry record closed); use lookup_corporate_number for details. Corporations marked as excluded from search on the NTA site are not included. / 名前の先頭から合う法人を探す（前方一致）。株式会社などの言葉は前後どちらにあっても無視し、全角・半角や空白の違いも吸収する。名前の途中からの検索とフリガナの検索はできない。最大100件。詳しい情報は lookup_corporate_number で。国税庁のサイトで検索対象除外の法人は入っていない。

## Query parameters

- `name` string, required: Beginning of the corporate name (e.g. トヨタ自動車) / 法人の名前の先頭（例：トヨタ自動車）
- `prefecture` string: Prefecture to narrow down (optional, e.g. 東京都 or 東京) / 都道府県で絞り込む（任意）

## Response `200`

OK

- Answer
  - `result` object, required: The answer / 結果
  - `source` object, required: Source and verification / 出典と照合の状況
  - `as_of` string, required: Reference date in Japan time (YYYY-MM-DD) / 基準日（日本時間）
  - `notes` string[], required: Assumptions such as estimated values / 前提（見込みの値など）
  - `flags` string[], required: `flags` holds machine-readable codes: `estimated` (a value is an estimate, e.g. a future equinox day — tell the user), `unverified` (year not yet checked against Cabinet Office data — tell the user), `assumes_current_era` (a future date written in the current era — tell the user), `outside_era` (the era date given is outside that era), `weekday_mismatch`, `closed` (the company's registry record is closed — tell the user), `excluded_from_search`, `truncated`, `not_found`, `exact_match_only`, `partial`, `ambiguous`, `city_not_found`, `ambiguous_city`.

## Other responses

- `400`: Invalid parameters / 入力の誤り
- `429`: Too many requests / 呼び出しが多すぎます
- `503`: Data unavailable / データを読めない

---

[API](https://skmtc.dev/ossalt/apis/japan-business-tools.md) · [All operations](https://skmtc.dev/ossalt/apis/japan-business-tools/llms.txt) · [OpenAPI document](https://skmtc.dev/ossalt/apis/japan-business-tools/revisions/8bb72a25e175?raw)