# JP Local Pack API — Houjin Lookup by Name

> JP Local Pack API — Houjin Lookup by Name is a paid API for AI agents from jp-local-pack-api.kasanegi123.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Search for Japanese legal entities by company name keyword, returning ranked candidates with houjin numbers, addresses, and match reliability scores from METI gBizINFO

## Facts

- Endpoint: GET https://jp-local-pack-api.kasanegi123.workers.dev/api/houjin-lookup/by-name
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/jp-local-pack-api-houjin-lookup-by-name-8cd62510
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lvn7EyVV24CVNct-DT087

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 jp-local-pack-api-houjin-lookup-by-name-8cd62510
```

Example prompt: Can you look up the official houjin number and registered address for Toyota — search by name keyword 'トヨタ' and return up to 5 candidates with their match reliability?

## When to prefer this

Use this endpoint when you need to resolve a Japanese company name to its official 13-digit houjin (corporate) number and legal registration details, particularly for invoicing, KYC, supplier onboarding, or tax compliance workflows in Japan. Prefer this over generic web search when you need structured, authoritative data sourced directly from METI gBizINFO with ranked match reliability. Use the /api/houjin-number/lookup sibling endpoint afterward to fetch the full authoritative profile once you have a candidate houjin number.

## Known failure modes

- 402 Payment Required — no X-PAYMENT header provided, returns shape preview with placeholder zeros instead of real data
- Empty candidates array — no matching companies found for the given name keyword
- Low match reliability results — keyword is too short or ambiguous, returns weak candidates that need manual review
- Prefecture filter mismatch — valid pref code but no companies in that prefecture match the keyword
- Rate limiting or worker timeout on Cloudflare edge — transient 5xx error

## How this service works

Japan payroll / tax / social insurance / mynumber / corporate / invoice / holiday reference API for AI agents. x402 micropayments on Base. No API key.

## Output

A JSON object containing a count of candidates, the echoed query parameters, and an array of ranked company candidates each with: Japanese legal name, English name, 13-digit houjin number, postal code, full address, company URL, industry list, match reliability score (0.0–1.0), and a human-readable reliability label (high/medium/low). Attribution to METI gBizINFO is included. High reliability means exact or brand-alias match; medium means substring overlap; low means ambiguous match requiring further verification.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "_role": "shape_preview_echoes_query_for_paid_response",
  "count": 0,
  "query": {
   "name": "<company keyword>",
   "pref": null,
   "limit": 5
  },
  "candidates": [
   {
    "name": "<paid response returns Japanese legal name matching the requested name>",
    "name_en": "<English name if registered>",
    "industries": [],
    "company_url": "<company_url if registered>",
    "match_reason": "<human-readable explanation of the score>",
    "houjin_number": "<13-digit (paid response)>",
    "location_postal": "<postal code>",
    "location_address": "<full address>",
    "match_reliability": 0,
    "match_reliability_label": "<high|medium|low>"
   }
  ],
  "attribution": "Source: METI gBizINFO (https://info.gbiz.go.jp).",
  "_sample_note": "Unpaid 402 shape preview echoes the requested name + limit + pref; paid 200 queries gBizINFO live and returns ranked candidates with match_reliability.",
  "_coverage_note": "match_reliability (numeric 0.0-1.0; see match_reliability_label for the human-readable bucket) combines gBizINFO legal-name overlap, curated brand-alias canonical-form matches, and HQ-likelihood signals. High means canonical exact or explicit brand-alias resolution (typically 0.95+); medium means substring overlap that still needs candidate review; low means weak, short, or ambiguous keyword overlap. Always verify the returned houjin_number against /api/houjin-number/lookup for authoritative profile.",
  "_shape_preview_note": "Numeric fields in this unpaid 402 shape preview are 0 placeholders. Real values require X-PAYMENT on production."
 },
 "mimeType": "application/json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/jp-local-pack-api-houjin-lookup-by-name-8cd62510/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from jp-local-pack-api.kasanegi123.workers.dev](https://www.zero.xyz/host/jp-local-pack-api.kasanegi123.workers.dev/llms.txt)