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

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 で。国税庁のサイトで検索対象除外の法人は入っていない。

get/v1/corporations/search

Request

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

Query parameters

namestring required

Beginning of the corporate name (e.g. トヨタ自動車) / 法人の名前の先頭(例:トヨタ自動車)

prefecturestring

Prefecture to narrow down (optional, e.g. 東京都 or 東京) / 都道府県で絞り込む(任意)

Response

OK

resultobject required

The answer / 結果

sourceobject required

Source and verification / 出典と照合の状況

as_ofstring required

Reference date in Japan time (YYYY-MM-DD) / 基準日(日本時間)

notesstring[] required

Assumptions such as estimated values / 前提(見込みの値など)

flagsstring[] 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.

Changes

No recorded changes to this operation across all 1 revision of this API.