Skip to main content
POST
National Tax Agency Companies Search

Authorizations

Authorization
string
header
required

Use Authorization: Bearer YOUR_API_KEY

Headers

Idempotency-Key
string

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.

Maximum string length: 255
Example:

"0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b"

Body

application/json
query
string
default:""

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.

Maximum string length: 200
prefecture
string
default:""

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

Maximum string length: 40
city
string
default:""

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

Maximum string length: 60
entity_type
enum<string>
default:""

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.

Available options:
,
national_government,
local_government,
kabushiki_kaisha,
yugen_kaisha,
gomei_kaisha,
goshi_kaisha,
godo_kaisha,
other_registered,
foreign_company,
other
status
enum<string>
default:""

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

Available options:
,
active,
closed
change_type
enum<string>
default:""

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.

Available options:
,
new,
name_change,
address_change,
foreign_address_change,
closed,
revived,
merger,
merger_annulled,
trade_name_erased,
deleted
from_date
string<date>
default:""

Optional date filter in yyyy-mm-dd format.

to_date
string<date>
default:""

Optional date filter in yyyy-mm-dd format.

page
integer
default:1

1-based page number for paginated results.

Required range: 1 <= x <= 1000
per_page
integer
default:20

Results per page (1-50).

Required range: 1 <= x <= 50

Response

Successful response

data
object
required