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

> El registro de empresas de Japón: busca unas seis millones de empresas y entidades por nombre, prefectura, forma jurídica o estado, y consulta cualquiera por su número.

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.

<Note>
  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](/es/datasets).
</Note>

## Buscar empresas

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

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.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Nombre de la empresa opcional, o cualquier parte, en japonés (`トヨタ自動車`), en su lectura (`トヨタジドウシャ`) o en inglés (`Toyota`). Dos o más caracteres. |
| `prefecture` | string | Prefectura opcional de la sede, por nombre (`東京都`, `大阪府`, `Aichi`) o código JIS de dos dígitos (`13`). |
| `city` | string | Ciudad, distrito, pueblo o aldea opcional de la sede como lo imprime el registro, p. ej. `千代田区`, `豊田市`, comparado desde el inicio. |
| `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` u `other`. |
| `status` | enum | Estado del registro opcional: `active` o `closed`. |
| `change_type` | enum | Tipo opcional del último cambio registrado: `new`, `name_change`, `address_change`, `foreign_address_change`, `closed`, `revived`, `merger`, `merger_annulled`, `trade_name_erased` o `deleted`. Con `from_date` y `to_date`, `new` lista las empresas registradas en un periodo. |
| `from_date` | string | Opcional: solo empresas cuyo último cambio es en esta fecha o después, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: solo empresas cuyo último cambio es en esta fecha o antes, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `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": "愛知県" }'
```

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.

<Note>
  `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.
</Note>

## Una empresa

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

| Campo | Tipo | Notas |
| - | - | - |
| `corporate_number` | string | **Obligatorio.** El número de empresa de 13 dígitos, p. ej. `1180301018771`. El primer dígito controla los otros doce. |

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

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.

<Note>
  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.
</Note>

Fuente: 国税庁法人番号公表サイト (Agencia Tributaria Nacional), bajo la Public Data License v1.0. Croma reorganiza las fichas en los campos de arriba.

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>


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