> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# National Tax Agency (法人番号)

> Japan's corporate number register: search about six million companies and other legal entities by name, prefecture, legal form or status, and look any one up by its number.

Japan's National Tax Agency assigns every company, foreign company, government body and other registered entity a 13-digit corporate number (法人番号) and publishes the register behind it: about six million records, each with the registered name, its reading and English form, the legal form, the head office down to the municipality and postal code, the status of the registration with the date and reason of any closure, the successor after a merger, and the last change recorded. Croma keeps the whole register and brings it up to date with the agency's daily difference files, so a search answers in milliseconds and the data is at most a business day behind the register.

Search by any part of the name in kanji, kana or English, narrowed by prefecture, city, legal form, status or the kind and date of the last change, or look one company up by its number.

<Note>
  The whole source, organized and ready to query: every endpoint on this page answers in milliseconds. Every response carries `as_of`: how current the data is. [How datasets work](/datasets).
</Note>

## Search companies

`POST /jp/nta/companies-search/v1` <a className="dataset-pill" href="/datasets">Dataset</a>

One search over the whole register, by any part of the name in any of its spellings, narrowed by prefecture, city, legal form, status or the last change.

| Field | Type | Notes |
| - | - | - |
| `query` | string | Optional company name, or any part of it, in Japanese (`トヨタ自動車`), in its reading (`トヨタジドウシャ`) or in English (`Toyota`). Two or more characters. |
| `prefecture` | string | Optional prefecture of the head office, by name (`東京都`, `大阪府`, `Aichi`) or two-digit JIS code (`13`). |
| `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` | enum | Optional legal form: `kabushiki_kaisha`, `yugen_kaisha`, `gomei_kaisha`, `goshi_kaisha`, `godo_kaisha`, `other_registered`, `foreign_company`, `national_government`, `local_government` or `other`. |
| `status` | enum | Optional registration status: `active` or `closed`. |
| `change_type` | enum | Optional kind of the last change the register recorded: `new`, `name_change`, `address_change`, `foreign_address_change`, `closed`, `revived`, `merger`, `merger_annulled`, `trade_name_erased` or `deleted`. With `from_date` and `to_date`, `new` lists the companies registered in a period. |
| `from_date` | string | Optional: only companies whose last change is on or after this date, `yyyy-mm-dd`. |
| `to_date` | string | Optional: only companies whose last change is on or before this date, `yyyy-mm-dd`. |
| `page` | integer | 1-based page number. Default `1`. |
| `per_page` | integer | Results per page (1-50). Default `20`. |

```bash theme={"dark"}
curl https://api.croma.run/jp/nta/companies-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "トヨタ自動車", "prefecture": "愛知県" }'
```

Returns `as_of` (how current the data is), the applied filters, `total` and `total_is_exact`, `page`, `per_page`, `total_pages`, `count` and `results[]`, most recently changed first. Every result carries `corporate_number` (the 13-digit 法人番号), `name`, `name_kana` (the reading), `name_en` (the English name, when registered), `entity_type` (`kabushiki_kaisha`, `yugen_kaisha`, `godo_kaisha`, `other_registered`, `foreign_company`...) with `entity_type_label` as the register prints it, the head office as `prefecture`, `prefecture_code` (JIS), `city`, `city_code`, `street`, `postal_code`, the English address when registered (`prefecture_en`, `city_en`), the address abroad (`address_outside_japan`, `address_outside_japan_en`), `status` (`active`, `closed` or `deleted`) with `closed_at`, `close_reason` and `successor_corporate_number`, `assigned_at`, `updated_at` (the register's last change), `changed_at`, `change_type` and `change_details`, `hidden` (kept out of the register's own name search), the register's images of a name or address it cannot print in full (`name_image_url`, `address_image_url`, `foreign_address_image_url`: Croma's byte-for-byte copies, with `source_*` for the register's own links; null for almost every company) and `official_url` (the company's page at the register). Fields the register does not state are null.

<Note>
  `query` matches any part of the name in any of its three spellings, so `トヨタ` finds トヨタ自動車株式会社 and every company with トヨタ in its name; add `prefecture` or `city` to narrow it. Companies the register keeps out of its own name search (`hidden`) are found only by number, with the National Tax Agency Company endpoint.
</Note>

## One company

`POST /jp/nta/company/v1` <a className="dataset-pill" href="/datasets">Dataset</a>

| Field | Type | Notes |
| - | - | - |
| `corporate_number` | string | **Required.** The company's 13-digit corporate number, e.g. `1180301018771`. The first digit checks the other twelve. |

```bash theme={"dark"}
curl https://api.croma.run/jp/nta/company/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "corporate_number": "1180301018771" }'
```

Returns `as_of`, `found`, `corporate_number` and `company`. Every result carries `corporate_number` (the 13-digit 法人番号), `name`, `name_kana` (the reading), `name_en` (the English name, when registered), `entity_type` (`kabushiki_kaisha`, `yugen_kaisha`, `godo_kaisha`, `other_registered`, `foreign_company`...) with `entity_type_label` as the register prints it, the head office as `prefecture`, `prefecture_code` (JIS), `city`, `city_code`, `street`, `postal_code`, the English address when registered (`prefecture_en`, `city_en`), the address abroad (`address_outside_japan`, `address_outside_japan_en`), `status` (`active`, `closed` or `deleted`) with `closed_at`, `close_reason` and `successor_corporate_number`, `assigned_at`, `updated_at` (the register's last change), `changed_at`, `change_type` and `change_details`, `hidden` (kept out of the register's own name search), the register's images of a name or address it cannot print in full (`name_image_url`, `address_image_url`, `foreign_address_image_url`: Croma's byte-for-byte copies, with `source_*` for the register's own links; null for almost every company) and `official_url` (the company's page at the register). Fields the register does not state are null.

<Note>
  A number the register has not assigned returns `found: false` with HTTP 200, not an error. A number with a wrong check digit is rejected as invalid.
</Note>

Source: 国税庁法人番号公表サイト (National Tax Agency), under the Public Data License v1.0. Croma reshapes the records into the fields above.

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, all response fields, and an interactive playground.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.