# Japanese Corporate Entity Resolution API

> Japanese Corporate Entity Resolution API is a paid API for AI agents from x402-ja-api.onrender.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Resolves a Japanese company name or 法人番号 (corporate number) into structured legal entity data including official name, address, and invoice number format

## Facts

- Endpoint: POST https://x402-ja-api.onrender.com/v1/company/resolve
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/japanese-corporate-entity-resolution-api-52a43426
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WZf7ZwG7lwN7mUE5TjaDm

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 japanese-corporate-entity-resolution-api-52a43426 -d '<json body>'
```

Example prompt: Can you look up トヨタ自動車 in the Japanese corporate registry and give me its official legal name, corporate number, and registered address?

## When to prefer this

Use this endpoint when you need to resolve a Japanese company name or 法人番号 into authoritative structured data from the Japanese corporate registry — especially for invoice/consumption tax compliance (インボイス制度), KYC/due diligence on Japanese business partners, or normalizing messy Japanese company names in a database. Prefer this over general web search when you need machine-readable structured output with the official corporate number and legal address. The optional prefecture code filter is useful when many companies share similar names and you know the company's operating region.

## Known failure modes

- No matching company found — returns empty candidates array with totalCount 0
- Ambiguous name matches multiple companies — returns multiple candidates requiring disambiguation
- Invalid 法人番号 format (not 13 digits or invalid T-prefix) — likely returns validation error
- Prefecture code filter is invalid (not matching ^[0-4][0-9]$ pattern) — request may fail or be ignored
- Service unavailable on render.com free tier — may return 503 or timeout after cold start
- Query exceeds 100 character maxLength — request rejected

## How this service works

Calendar and Japan data APIs for AI agents: worldwide holidays and business days (200+ countries), plus Japanese text-to-structure (address, name, bank, company normalization). Pay per call in USDC via x402, no API key.

## Output

Returns a JSON object with the original query, how it was matched (by name or corporate number), total candidate count, and an array of candidate companies. Each candidate includes the official Japanese company name, 13-digit corporate number, T-prefixed invoice number, company kind code and label (e.g. 株式会社), active/closed status, and a fully structured registered address with prefecture, city, street, and formatted postal code.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "maxLength": 100,
   "description": "13-digit 法人番号 (optionally prefixed with T) or a company name in any notation"
  },
  "prefectureCode": {
   "type": "string",
   "pattern": "^[0-4][0-9]$",
   "description": "Optional JIS prefecture code filter"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "トヨタ自動車",
  "matchedBy": "name",
  "candidates": [
   {
    "kind": "301",
    "name": "トヨタ自動車株式会社",
    "closed": false,
    "address": {
     "city": "豊田市",
     "street": "トヨタ町1番地",
     "postCode": "4718571",
     "formatted": "愛知県豊田市トヨタ町1番地",
     "prefecture": "愛知県"
    },
    "kindLabel": "株式会社",
    "exactNameMatch": true,
    "corporateNumber": "1180301018771",
    "invoiceNumberFormat": "T1180301018771"
   }
  ],
  "totalCount": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/japanese-corporate-entity-resolution-api-52a43426/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-ja-api.onrender.com](https://www.zero.xyz/host/x402-ja-api.onrender.com/llms.txt)