# JP Local Pack API — Invoice Issuer Lookup by Name

> JP Local Pack API — Invoice Issuer 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-14).

Looks up Japan qualified invoice issuers by company name, returning T-number, registration status, and match reliability from NTA and gBizINFO registries.

## Facts

- Endpoint: GET https://jp-local-pack-api.kasanegi123.workers.dev/api/invoice/issuer-by-name
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/jp-local-pack-api-invoice-issuer-lookup-by-name-67f419d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__UBBsjbB2_Kd22mrtvKQf

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-invoice-issuer-lookup-by-name-67f419d2
```

Example prompt: Can you check whether 'Toyota Tsusho Corporation' is a registered qualified invoice issuer in Japan and give me their T-number and registration status?

## When to prefer this

Use this endpoint when you need to verify a Japanese company's qualified invoice issuer status by name — especially for accounts payable, tax compliance, or supplier onboarding workflows in Japan. Prefer this over manual NTA registry lookups when automating invoice validation at scale. Best when you have a supplier name but not yet their T-number or houjin number.

## Known failure modes

- Ambiguous company name returns multiple low-reliability candidates requiring manual review
- Company not found in gBizINFO returns empty candidates list
- NTA registry cache miss results in unverified lower candidates with registration_error
- Unpaid request (no X-PAYMENT header) returns 402 shape preview with placeholder zeros instead of real data
- Non-Japanese company names or romanized names may fail to match Japanese registry entries

## 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

Returns a list of candidate companies matching the name query, each with: Japanese legal name, English name (if available), 13-digit T-number, houjin number, registration status (registered/not), match reliability score and label (high/medium/low), full registered address, registration date, and data source cache status. Includes attribution to upstream METI gBizINFO and NTA registries.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "_role": "shape_preview_echoes_query_for_paid_response",
  "count": 0,
  "query": {
   "name": "<supplier keyword>",
   "limit": 5
  },
  "candidates": [
   {
    "name": "<paid response returns Japanese legal name matching the requested name>",
    "active": true,
    "name_en": "<English name if registered>",
    "t_number": "T<13-digit verified in paid response>",
    "match_reason": "<human-readable explanation of the score>",
    "houjin_number": "<13-digit corresponding hojin_bango>",
    "registered_at": "<YYYY-MM-DD>",
    "location_address": "<full address>",
    "match_reliability": 0,
    "registration_name": "<NTA registered name>",
    "registration_status": "registered",
    "registration_address": "<NTA registered address>",
    "registration_verified": true,
    "match_reliability_label": "<high|medium|low>",
    "registration_cache_status": "<registry_hit|registry_not_found|webapi_cache_hit|webapi_cache_miss|webapi_uncached>",
    "registration_source_last_update_date": "<YYYY-MM-DD>"
   }
  ],
  "attribution": "Upstreams: METI gBizINFO (https://info.gbiz.go.jp) for name -> houjin_number; NTA qualified invoice issuer public download registry for registration status.",
  "_sample_note": "Unpaid 402 shape preview echoes the requested name + limit; paid 200 queries gBizINFO and the NTA registry, then returns t_number candidates with registration_status and match_reliability.",
  "_shape_preview_note": "Numeric fields in this unpaid 402 shape preview are 0 placeholders. Real values require X-PAYMENT on production.",
  "_coverage_limitation": "Paid response returns candidate-level NTA status evidence. The top candidate is verified against the NTA public download registry when available; lower candidates may be unverified and include registration_error. Remaining limitation: name-search uses gBizINFO keyword resolution, so ambiguous supplier names still need candidate review."
 },
 "mimeType": "application/json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/jp-local-pack-api-invoice-issuer-lookup-by-name-67f419d2/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)