---
title: "National Tax Agency Company"
method: POST
path: "/jp/nta/company/v1"
tags: ["Japan", "National Tax Agency of Japan"]
---

# National Tax Agency Company

`POST /jp/nta/company/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/jp/nta/company/v1`
- Auth: HTTP bearer

Retrieve one Japanese company or other legal entity by its 13-digit corporate number (法人番号), e.g. `1180301018771`: the registered name with its reading and English form, the legal form, the head office, the registration status with any closure and successor, and the last change the register recorded. 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
  - `corporate_number` string, required: The company's 13-digit corporate number (法人番号), e.g. `1180301018771`. The first digit checks the other twelve.

## Response `200`

Successful response

- NtaCompanyResponse
  - `data` NtaCompanyData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `found` boolean, required
    - `corporate_number` string, required
    - `company` object, nullable, 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)