Skip to main content
La Agencia Tributaria Nacional de Japón asigna a cada empresa, empresa extranjera, órgano de gobierno y otra entidad registrada un número de empresa de 13 dígitos (法人番号) y publica el registro que hay detrás: unas seis millones de fichas, cada una con el nombre registrado, su lectura y su forma en inglés, la forma jurídica, la sede hasta el municipio y el código postal, el estado del registro con la fecha y la causa de cualquier cierre, la sucesora tras una fusión y el último cambio registrado. Croma conserva el registro completo y lo mantiene al día con los archivos de diferencias diarios de la agencia, así que una búsqueda responde en milisegundos y los datos están como mucho un día hábil por detrás del registro. Busca por cualquier parte del nombre en kanji, kana o inglés, acotando por prefectura, ciudad, forma jurídica, estado o el tipo y la fecha del último cambio, o consulta una empresa por su número.
La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye as_of: qué tan actualizados están los datos. Cómo funcionan los datasets.

​
Buscar empresas

POST /jp/nta/companies-search/v1 Dataset Una sola búsqueda sobre todo el registro, por cualquier parte del nombre en cualquiera de sus escrituras, acotada por prefectura, ciudad, forma jurídica, estado o último cambio.
Devuelve as_of (qué tan actualizados están los datos), los filtros aplicados, total y total_is_exact, page, per_page, total_pages, count y results[], del cambio más reciente al más antiguo. Cada resultado incluye corporate_number (el 法人番号 de 13 dígitos), name, name_kana (la lectura), name_en (el nombre en inglés, si está registrado), entity_type (kabushiki_kaisha, yugen_kaisha, godo_kaisha, other_registered, foreign_company…) con entity_type_label tal como lo imprime el registro, la sede como prefecture, prefecture_code (JIS), city, city_code, street, postal_code, la dirección en inglés si está registrada (prefecture_en, city_en), la dirección en el exterior (address_outside_japan, address_outside_japan_en), status (active, closed o deleted) con closed_at, close_reason y successor_corporate_number, assigned_at, updated_at (el último cambio del registro), changed_at, change_type y change_details, hidden (excluida de la búsqueda por nombre del propio registro), las imágenes que el registro publica para un nombre o una dirección que no puede imprimir completos (name_image_url, address_image_url, foreign_address_image_url: copias de Croma byte a byte, con source_* para los enlaces del registro; null en casi todas las empresas) y official_url (la página de la empresa en el registro). Los campos que el registro no indica vienen en null.
query busca cualquier parte del nombre en cualquiera de sus tres escrituras, así que トヨタ encuentra トヨタ自動車株式会社 y toda empresa con トヨタ en el nombre; añade prefecture o city para acotar. Las empresas que el registro excluye de su propia búsqueda por nombre (hidden) solo se encuentran por número, con el endpoint National Tax Agency Company.

​
Una empresa

POST /jp/nta/company/v1 Dataset
Devuelve as_of, found, corporate_number y company. Cada resultado incluye corporate_number (el 法人番号 de 13 dígitos), name, name_kana (la lectura), name_en (el nombre en inglés, si está registrado), entity_type (kabushiki_kaisha, yugen_kaisha, godo_kaisha, other_registered, foreign_company…) con entity_type_label tal como lo imprime el registro, la sede como prefecture, prefecture_code (JIS), city, city_code, street, postal_code, la dirección en inglés si está registrada (prefecture_en, city_en), la dirección en el exterior (address_outside_japan, address_outside_japan_en), status (active, closed o deleted) con closed_at, close_reason y successor_corporate_number, assigned_at, updated_at (el último cambio del registro), changed_at, change_type y change_details, hidden (excluida de la búsqueda por nombre del propio registro), las imágenes que el registro publica para un nombre o una dirección que no puede imprimir completos (name_image_url, address_image_url, foreign_address_image_url: copias de Croma byte a byte, con source_* para los enlaces del registro; null en casi todas las empresas) y official_url (la página de la empresa en el registro). Los campos que el registro no indica vienen en null.
Un número que el registro no ha asignado devuelve found: false con HTTP 200, no un error. Un número con el dígito de control incorrecto se rechaza como inválido.
Fuente: 国税庁法人番号公表サイト (Agencia Tributaria Nacional), bajo la Public Data License v1.0. Croma reorganiza las fichas en los campos de arriba.

Referencia completa

Esquemas, todos los campos de respuesta y un playground interactivo.