> ## 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 (法人番号)

> O registro de empresas do Japão: busque cerca de seis milhões de empresas e entidades por nome, prefeitura, forma jurídica ou situação, e consulte qualquer uma pelo seu número.

A Agência Tributária Nacional do Japão atribui a cada empresa, empresa estrangeira, órgão de governo e outra entidade registrada um número de empresa de 13 dígitos (法人番号) e publica o registro por trás dele: cerca de seis milhões de fichas, cada uma com o nome registrado, sua leitura e sua forma em inglês, a forma jurídica, a sede até o município e o código postal, a situação do registro com a data e o motivo de qualquer encerramento, a sucessora após uma fusão e a última alteração registrada. A Croma mantém o registro inteiro e o atualiza com os arquivos de diferenças diários da agência, então uma busca responde em milissegundos e os dados estão no máximo um dia útil atrás do registro.

Busque por qualquer parte do nome em kanji, kana ou inglês, restringindo por prefeitura, cidade, forma jurídica, situação ou o tipo e a data da última alteração, ou consulte uma empresa pelo seu número.

<Note>
  A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
</Note>

## Buscar empresas

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

Uma única busca sobre todo o registro, por qualquer parte do nome em qualquer das suas grafias, restringida por prefeitura, cidade, forma jurídica, situação ou última alteração.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Nome da empresa opcional, ou qualquer parte, em japonês (`トヨタ自動車`), na sua leitura (`トヨタジドウシャ`) ou em inglês (`Toyota`). Dois ou mais caracteres. |
| `prefecture` | string | Prefeitura opcional da sede, por nome (`東京都`, `大阪府`, `Aichi`) ou código JIS de dois dígitos (`13`). |
| `city` | string | Cidade, distrito, vila ou aldeia opcional da sede como o registro a imprime, p. ex. `千代田区`, `豊田市`, comparada desde o início. |
| `entity_type` | enum | Forma jurídica opcional: `kabushiki_kaisha`, `yugen_kaisha`, `gomei_kaisha`, `goshi_kaisha`, `godo_kaisha`, `other_registered`, `foreign_company`, `national_government`, `local_government` ou `other`. |
| `status` | enum | Situação do registro opcional: `active` ou `closed`. |
| `change_type` | enum | Tipo opcional da última alteração registrada: `new`, `name_change`, `address_change`, `foreign_address_change`, `closed`, `revived`, `merger`, `merger_annulled`, `trade_name_erased` ou `deleted`. Com `from_date` e `to_date`, `new` lista as empresas registradas em um período. |
| `from_date` | string | Opcional: só empresas cuja última alteração é nesta data ou depois, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: só empresas cuja última alteração é nesta data ou antes, `yyyy-mm-dd`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-50). Por padrão `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": "愛知県" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`, da alteração mais recente à mais antiga. Cada resultado traz `corporate_number` (o 法人番号 de 13 dígitos), `name`, `name_kana` (a leitura), `name_en` (o nome em inglês, quando registrado), `entity_type` (`kabushiki_kaisha`, `yugen_kaisha`, `godo_kaisha`, `other_registered`, `foreign_company`...) com `entity_type_label` como o registro o imprime, a sede como `prefecture`, `prefecture_code` (JIS), `city`, `city_code`, `street`, `postal_code`, o endereço em inglês quando registrado (`prefecture_en`, `city_en`), o endereço no exterior (`address_outside_japan`, `address_outside_japan_en`), `status` (`active`, `closed` ou `deleted`) com `closed_at`, `close_reason` e `successor_corporate_number`, `assigned_at`, `updated_at` (a última alteração do registro), `changed_at`, `change_type` e `change_details`, `hidden` (excluída da busca por nome do próprio registro), as imagens que o registro publica para um nome ou endereço que não consegue imprimir por inteiro (`name_image_url`, `address_image_url`, `foreign_address_image_url`: cópias da Croma byte a byte, com `source_*` para os links do registro; null em quase todas as empresas) e `official_url` (a página da empresa no registro). Os campos que o registro não indica vêm como null.

<Note>
  `query` busca qualquer parte do nome em qualquer das suas três grafias, então `トヨタ` encontra トヨタ自動車株式会社 e toda empresa com トヨタ no nome; acrescente `prefecture` ou `city` para restringir. As empresas que o registro exclui da sua própria busca por nome (`hidden`) só são encontradas por número, com o endpoint National Tax Agency Company.
</Note>

## Uma empresa

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

| Campo | Tipo | Notas |
| - | - | - |
| `corporate_number` | string | **Obrigatório.** O número de empresa de 13 dígitos, p. ex. `1180301018771`. O primeiro dígito verifica os outros doze. |

```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" }'
```

Retorna `as_of`, `found`, `corporate_number` e `company`. Cada resultado traz `corporate_number` (o 法人番号 de 13 dígitos), `name`, `name_kana` (a leitura), `name_en` (o nome em inglês, quando registrado), `entity_type` (`kabushiki_kaisha`, `yugen_kaisha`, `godo_kaisha`, `other_registered`, `foreign_company`...) com `entity_type_label` como o registro o imprime, a sede como `prefecture`, `prefecture_code` (JIS), `city`, `city_code`, `street`, `postal_code`, o endereço em inglês quando registrado (`prefecture_en`, `city_en`), o endereço no exterior (`address_outside_japan`, `address_outside_japan_en`), `status` (`active`, `closed` ou `deleted`) com `closed_at`, `close_reason` e `successor_corporate_number`, `assigned_at`, `updated_at` (a última alteração do registro), `changed_at`, `change_type` e `change_details`, `hidden` (excluída da busca por nome do próprio registro), as imagens que o registro publica para um nome ou endereço que não consegue imprimir por inteiro (`name_image_url`, `address_image_url`, `foreign_address_image_url`: cópias da Croma byte a byte, com `source_*` para os links do registro; null em quase todas as empresas) e `official_url` (a página da empresa no registro). Os campos que o registro não indica vêm como null.

<Note>
  Um número que o registro não atribuiu retorna `found: false` com HTTP 200, não um erro. Um número com o dígito verificador errado é rejeitado como inválido.
</Note>

Fonte: 国税庁法人番号公表サイト (Agência Tributária Nacional), sob a Public Data License v1.0. A Croma reorganiza as fichas nos campos acima.

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>


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