Skip to main content
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.
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.

​
Search companies

POST /jp/nta/companies-search/v1 Dataset 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.
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.
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.

​
One company

POST /jp/nta/company/v1 Dataset
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.
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.
Source: 国税庁法人番号公表サイト (National Tax Agency), under the Public Data License v1.0. Croma reshapes the records into the fields above.

Full reference

Schemas, all response fields, and an interactive playground.