---
title: "National Tax Agency Companies Search"
method: POST
path: "/jp/nta/companies-search/v1"
tags: ["Japan", "National Tax Agency of Japan"]
---

# National Tax Agency Companies Search

`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

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`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `query` string: 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.
  - `prefecture` string: Optional prefecture of the head office, as the register prints it (`東京都`, `大阪府`, `北海道`, `沖縄県`) or as its two-digit JIS code (`13` for Tokyo).
  - `city` string: 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_date` string, date: Optional date filter in yyyy-mm-dd format.
  - `to_date` string, date: Optional date filter in yyyy-mm-dd format.
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Results per page (1-50).

## Response `200`

Successful response

- NtaCompaniesSearchResponse
  - `data` NtaCompaniesSearchData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `query` string, required
    - `prefecture` string, nullable, required
    - `city` string, nullable, required
    - `entity_type` string, nullable, required
    - `status` string, nullable, required
    - `change_type` string, nullable, required
    - `from_date` string, nullable, required
    - `to_date` string, nullable, required
    - `total` number, required: Matches, counted up to 1000.
    - `total_is_exact` boolean, required: False when more than 1000 match: `total` is then 1000, and the pages go on.
    - `page` number, required
    - `per_page` number, required
    - `total_pages` number, required: Pages over `total`; there are more when `total_is_exact` is false.
    - `count` number, required
    - `results` object[], required
      - `corporate_number` string, required: The 13-digit corporate number (法人番号) the National Tax Agency assigned, e.g. "1180301018771". The first digit checks the other twelve.
      - `name` string, required: The company's name (商号又は名称) as registered, e.g. "トヨタ自動車株式会社". Cut at 150 characters by the register; `name_image_url` then carries the whole of it.
      - `name_kana` string, nullable, required: The reading of the name in katakana (フリガナ), when the register records one.
      - `name_en` string, nullable, required: The name in English, when the company registered one.
      - `entity_type` 'national_government' | 'local_government' | 'kabushiki_kaisha' | 'yugen_kaisha' | 'gomei_kaisha' | 'goshi_kaisha' | 'godo_kaisha' | 'other_registered' | 'foreign_company' | 'other', required: The legal form: `kabushiki_kaisha` (株式会社), `yugen_kaisha` (有限会社), `gomei_kaisha` (合名会社), `goshi_kaisha` (合資会社), `godo_kaisha` (合同会社), `other_registered` (any other registered entity: 一般社団法人, 医療法人, 学校法人, 宗教法人...), `foreign_company` (外国会社), `national_government`, `local_government` or `other`.
      - `entity_type_label` string, required: The legal form as the register labels it, e.g. "株式会社", "その他の設立登記法人".
      - `prefecture` string, nullable, required: The prefecture of the head office (国内所在地), e.g. "愛知県", "東京都". Null for a company whose only address is abroad.
      - `prefecture_code` string, nullable, required: The prefecture's two-digit JIS X 0401 code, e.g. "23" for 愛知県, "13" for 東京都.
      - `city` string, nullable, required: The city, ward, town or village of the head office, e.g. "豊田市", "千代田区".
      - `city_key` string, nullable, required: `city` folded for matching (compatibility forms normalized, lowercased), which is what the `city` filter matches from the start.
      - `city_code` string, nullable, required: The municipality's five-digit JIS X 0402 code, e.g. "23211".
      - `street` string, nullable, required: The rest of the head office address (丁目番地等), e.g. "トヨタ町1番地". Cut at 300 characters by the register; `address_image_url` then carries the whole address.
      - `postal_code` string, nullable, required: The seven-digit postal code the register derives from the address. Derived, so it can be wrong or missing.
      - `prefecture_en` string, nullable, required: The prefecture in English, when the company registered its address in English.
      - `city_en` string, nullable, required: The city and the rest of the address in English, when the company registered them.
      - `address_outside_japan` string, nullable, required: The address abroad (国外所在地) for a foreign company, as registered.
      - `address_outside_japan_en` string, nullable, required: The address abroad in English, when registered.
      - `status` 'active' | 'closed' | 'deleted', required: `active` while the register record is open, `closed` once it was closed (see `close_reason`), `deleted` when the register removed the number.
      - `closed_at` string, nullable, required: `yyyy-mm-dd` the register record was closed. Null while active.
      - `close_reason` 'liquidation' | 'merger' | 'registrar' | 'other_liquidation', nullable, required: Why the record was closed: `liquidation` (清算の結了等), `merger` (合併による解散等), `registrar` (登記官による閉鎖) or `other_liquidation` (その他の清算の結了等). Null while active.
      - `successor_corporate_number` string, nullable, required: The corporate number of the company this one was merged into, when it closed by merger.
      - `assigned_at` string, nullable, required: `yyyy-mm-dd` the corporate number was assigned. `2015-10-05` for every company that existed when the system started.
      - `updated_at` string, required: `yyyy-mm-dd` the register last changed the record; what `from_date` and `to_date` filter on.
      - `changed_at` string, nullable, required: `yyyy-mm-dd` of the event behind the last change (the registration date of the change), when the register states it.
      - `change_type` 'new' | 'name_change' | 'address_change' | 'foreign_address_change' | 'closed' | 'revived' | 'merger' | 'merger_annulled' | 'trade_name_erased' | 'deleted', required: The last change the register recorded: `new`, `name_change`, `address_change`, `foreign_address_change`, `closed`, `revived`, `merger`, `merger_annulled`, `trade_name_erased` or `deleted`.
      - `change_details` string, nullable, required: The register's own note on the last change (変更事由の詳細), when it wrote one.
      - `hidden` boolean, required: True for a company the register keeps out of its own name search; it is then found only by its corporate number here as well.
      - `name_image_url` string, nullable, required: Croma's copy of the image the register publishes for a name it cannot print in full (characters outside JIS, or more than 150 characters), byte for byte. Null for almost every company.
      - `source_name_image_url` string, nullable, required: The register's own link to that image.
      - `address_image_url` string, nullable, required: Croma's copy of the image the register publishes for an address it cannot print in full. Null for almost every company.
      - `source_address_image_url` string, nullable, required: The register's own link to that image.
      - `foreign_address_image_url` string, nullable, required: Croma's copy of the image the register publishes for an address abroad it cannot print in full.
      - `source_foreign_address_image_url` string, nullable, required: The register's own link to that image.
      - `official_url` string, required: The company's page at the National Tax Agency's corporate number site.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)