{"uid":"cap__UBBsjbB2_Kd22mrtvKQf","slug":"jp-local-pack-api-invoice-issuer-lookup-by-name-67f419d2","name":"JP Local Pack API — Invoice Issuer Lookup by Name","description":"Japan payroll / tax / social insurance / mynumber / corporate / invoice / holiday reference API for AI agents. x402 micropayments on Base. No API key.","url":"https://jp-local-pack-api.kasanegi123.workers.dev/api/invoice/issuer-by-name","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"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"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NUnQNNXQU48rIomiUJ6v-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up Japan qualified invoice issuers by company name, returning T-number, registration status, and match reliability from NTA and gBizINFO registries.","exampleAgentPrompt":"Can you check whether 'Toyota Tsusho Corporation' is a registered qualified invoice issuer in Japan and give me their T-number and registration status?","exampleUseCases":[{"title":"Vendor invoice eligibility verification","prompt":"We're about to pay an invoice from a new Japanese supplier called Mitsubishi Electric. Can you quickly verify they're registered as a qualified invoice issuer and grab their T-number so we know the invoice is legit?"},{"title":"Bulk supplier onboarding compliance","prompt":"I'm setting up our new supplier database for Japan operations. Can you look up each of these company names and tell me which ones are registered qualified invoice issuers? I need their T-numbers and registration statuses to flag any compliance issues upfront."},{"title":"Tax audit readiness check","prompt":"Our accounting team needs to audit all invoices we received from Japanese vendors last quarter. Can you verify a few key suppliers like Sony and Panasonic to confirm they were actually registered qualified invoice issuers at the time, and pull their houjin numbers and registration dates?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:37:18.888Z","isFirstParty":false}