# Houjin Corporate Registry Stats

> Houjin Corporate Registry Stats is a paid API for AI agents from houjin.agentic-jp.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns dataset metadata for the Japanese corporate-number API, including total corporation count and list of covered prefectures.

## Facts

- Endpoint: GET https://houjin.agentic-jp.com/stats
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/houjin-agentic-jp-com-a59f9c7e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OcZX7AE8-h_Bs5VfpzxqR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability houjin-agentic-jp-com-a59f9c7e
```

Example prompt: How many Japanese corporations are currently loaded in the houjin registry, and which of Japan's 47 prefectures are covered?

## When to prefer this

Use this endpoint to verify dataset coverage and health before making corporate lookup queries — especially to confirm all 47 Japanese prefectures are indexed and to get the total corporation count. Prefer this over the lookup endpoint when you only need metadata about the dataset rather than information about a specific company.

## Known failure modes

- Service unavailable: dataset not yet loaded (loaded: false)
- Network timeout if the stats endpoint is temporarily down
- Unexpected empty prefecture list if data indexing is in progress

## How this service works

Dataset metadata for this Japanese (JP) corporate-number API — how many corporations are loaded and which prefectures are covered.

## Output

Returns a JSON object with: loaded (boolean), data_source name (National Tax Agency of Japan), an array of all covered prefecture names in Japanese, prefecture_count (integer, up to 47), corporation_count (integer, e.g. 5,780,145), and attribution text.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "loaded": true,
  "data_source": "国税庁 法人番号公表サイト",
  "prefectures": [
   "東京都"
  ],
  "prefecture_count": 1,
  "corporation_count": 1074321
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/houjin-agentic-jp-com-a59f9c7e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from houjin.agentic-jp.com](https://www.zero.xyz/host/houjin.agentic-jp.com/llms.txt)
