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

​
Buscar empresas

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

​
Uma empresa

POST /jp/nta/company/v1 Dataset
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.
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.
Fonte: 国税庁法人番号公表サイト (Agência Tributária Nacional), sob a Public Data License v1.0. A Croma reorganiza as fichas nos campos acima.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.