# Japan Corporate-Number API (x402)

> Japan Corporate-Number API (x402) is a paid API for AI agents from houjin.agentic-jp.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Looks up and verifies Japanese corporations from the National Tax Agency registry using fuzzy name search, returning confidence scores and full corporate details.

## Facts

- Endpoint: POST https://houjin.agentic-jp.com/verify
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/japan-corporate-number-api-x402-4b78c941
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8MctFSg6XbYnrYCJugA89

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 japan-corporate-number-api-x402-4b78c941 -d '<json body>'
```

Example prompt: Can you verify that 国立印刷局 in 港区, Tokyo is a legitimately registered Japanese corporation and get me their official corporate number from the National Tax Agency registry?

## When to prefer this

Use this endpoint when you need to verify, look up, or reconcile Japanese corporate entities against the authoritative National Tax Agency registry. Ideal for KYB/compliance workflows, vendor onboarding, and payment due-diligence involving Japanese companies. Prefer over general web search when you need an authoritative, structured registry result with a confidence score. The x402 pay-per-call model (no API key required) makes it convenient for ad-hoc or infrequent lookups without subscription overhead.

## Known failure modes

- No matching corporation found — returns empty candidates array and verified: false
- Multiple low-confidence candidates — returns candidates list without a clear best match
- Payment failure via x402 — call not processed if USDC payment is not confirmed
- Ambiguous name requiring prefecture/city disambiguation — confidence score below threshold
- Invalid or non-existent corporate number provided — mismatch returned with verified: false

## How this service works

KYB / KYC verification of a Japanese company: reconcile a company name (+ optional address) against the official JP corporate registry (名寄せ). Returns ranked candidate 法人番号 with a 0-1 confidence score, handling 株式会社 / (株) / ㈱ spelling variation and matching Japanese or English names. A dissolved corporation is never reported as `verified` even on an exact name match. Use it to confirm a vendor, customer, or invoice counterparty.

## Output

Returns a verified boolean, a best-match candidate with confidence score (0–1), and full corporation details including official name, corporate number, status (active/closed), address components (prefecture, city, street, postal code), corporation kind, assignment date, and update date. Also returns a candidates array for fuzzy matches with match flags for name, city, and prefecture.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "city": {
   "type": "string",
   "description": "City / ward, to disambiguate. Optional."
  },
  "name": {
   "type": "string",
   "description": "Corporation name to reconcile against the registry. Required."
  },
  "prefecture": {
   "type": "string",
   "description": "Prefecture, to disambiguate. Optional."
  },
  "corporate_number": {
   "type": "string",
   "description": "A 法人番号 the caller wants confirmed against the name/address. Optional."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "best": {
   "matched": {
    "city": true,
    "name": true,
    "name_exact": true,
    "prefecture": true
   },
   "confidence": 0.96,
   "corporation": {
    "city": "港区",
    "name": "国立印刷局",
    "status": "active",
    "street": "虎ノ門二丁目2番5号",
    "name_en": null,
    "corp_kind": "101",
    "name_kana": null,
    "address_en": null,
    "close_date": null,
    "prefecture": "東京都",
    "change_date": "2015-10-05",
    "close_cause": null,
    "postal_code": "1058445",
    "update_date": "2018-04-02",
    "address_full": "東京都港区虎ノ門二丁目2番5号",
    "process_kind": "01",
    "assignment_date": "2015-10-05",
    "corp_kind_label": "National government agency",
    "prefecture_code": "13",
    "corporate_number": "7000012050002",
    "close_cause_label": null,
    "successor_corporate_number": null
   }
  },
  "verified": true,
  "candidates": [
   {
    "matched": {
     "city": true,
     "name": true,
     "name_exact": true,
     "prefecture": true
    },
    "confidence": 0.96,
    "corporation": {
     "city": "港区",
     "name": "国立印刷局",
     "status": "active",
     "street": "虎ノ門二丁目2番5号",
     "name_en": null,
     "corp_kind": "101",
     "name_kana": null,
     "address_en": null,
     "close_date": null,
     "prefecture": "東京都",
     "change_date": "2015-10-05",
     "close_cause": null,
     "postal_code": "1058445",
     "update_date": "2018-04-02",
     "address_full": "東京都港区虎ノ門二丁目2番5号",
     "process_kind": "01",
     "assignment_date": "2015-10-05",
     "corp_kind_label": "National government agency",
     "prefecture_code": "13",
     "corporate_number": "7000012050002",
     "close_cause_label": null,
     "successor_corporate_number": null
    }
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/japan-corporate-number-api-x402-4b78c941/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)