Japan
National Tax Agency of Japan

National Tax Agency Companies Search

Search Japan's corporate number register (法人番号), about six million companies and other legal entities, by any part of the name in kanji, kana or English, narrowed by prefecture (name or JIS code), city, entity_type (the legal form), status (active or closed), change_type (the last change the register recorded) and the date of that change (from_date/to_date). Each result carries the corporate number, the names, the legal form, the head office, the registration status with any closure, and the last change. Served by Croma from its copy of the register (as_of says how current the data is).

Dataset endpoint: answers from the whole source in milliseconds and carries as_of.

post/jp/nta/companies-search/v1

Request

  • Base URL: https://api.croma.run
  • URL: https://api.croma.run/jp/nta/companies-search/v1
  • Auth: HTTP bearer

Headers

Idempotency-Keystring
Example:0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b

Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the Idempotency-Key response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit.

Request body

querystring

Optional company name, or any part of it, as the register spells it: in Japanese (トヨタ自動車, トヨタ), in its reading (トヨタジドウシャ) or in English where the company registered one (Toyota). Two or more characters; every word must appear.

prefecturestring

Optional prefecture of the head office, as the register prints it (東京都, 大阪府, 北海道, 沖縄県) or as its two-digit JIS code (13 for Tokyo).

citystring

Optional city, ward, town or village of the head office as the register prints it, e.g. 千代田区, 横浜市西区, 豊田市, matched from the start.

entity_type'' | 'national_government' | 'local_government' | 'kabushiki_kaisha' | 'yugen_kaisha' | 'gomei_kaisha' | 'goshi_kaisha' | 'godo_kaisha' | 'other_registered' | 'foreign_company' | 'other'

Optional legal form: kabushiki_kaisha (株式会社), yugen_kaisha (有限会社), gomei_kaisha (合名会社), goshi_kaisha (合資会社), godo_kaisha (合同会社), other_registered (other registered entities such as 一般社団法人, 医療法人, 学校法人), foreign_company (外国会社), national_government, local_government or other.

status'' | 'active' | 'closed'

Optional registration status: active (the register record is open) or closed (closed after liquidation, a merger or by the registrar).

change_type'' | 'new' | 'name_change' | 'address_change' | 'foreign_address_change' | 'closed' | 'revived' | 'merger' | 'merger_annulled' | 'trade_name_erased' | 'deleted'

Optional kind of the last change the register recorded for the company: new (number assigned), name_change, address_change, foreign_address_change, closed, revived, merger (absorbed into another company), merger_annulled, trade_name_erased or deleted. With from_date and to_date, this finds for example every company registered in a period.

from_datestring date

Optional date filter in yyyy-mm-dd format.

to_datestring date

Optional date filter in yyyy-mm-dd format.

pageinteger

1-based page number for paginated results.

per_pageinteger

Results per page (1-50).

Response

Successful response

Changes

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