Find Japanese companies (法人) by name and return candidate corporate numbers (法人番号). Use this when the user gives a company name instead of a number, e.g. 「トヨタ自動車」「㈱サンプル 大阪」「sample shoji」. Name variants are absorbed automatically (株式会社/㈱/(株), full-width/half-width, spaces), so pass the name as the user wrote it; do not guess a 13-digit number. Narrow with prefecture when the user mentions a place. Results are ranked by score (0-1). If several candidates look plausible, ask the user which one they mean (show name and prefecture) instead of picking one. Then call bango_get_company with the chosen corporate_number for address and invoice status. Each call uses 1 API request from the user's Bango API quota.

Look up one Japanese company or invoice issuer by its corporate number (法人番号, 13 digits) or invoice registration number (登録番号, 'T' + 13 digits). Hyphens, spaces and full-width digits are accepted, e.g. 「T1-1803-0101-8771」. Returns official name, kana, address, whether the company is still active (閉鎖の有無), and its invoice registration status (有効/失効/登録取消/未登録). T-numbers of sole proprietors (個人事業主) also work, but personal address is returned only if the person chose to publish it. If you only have a company name, call bango_find_company first. Uses 1 API request.

Check whether invoice registration numbers (適格請求書発行事業者の登録番号, T + 13 digits) are valid, for one or many numbers at once (up to 20). Typical use: verifying the T-number printed on an invoice or receipt before claiming input tax credit (仕入税額控除). Without date, checks validity as of today (JST) and also returns the registered name so the user can compare it with the invoice. With date (e.g. the invoice issue date), checks validity on that date; the name is not returned in that mode. A number with only 13 digits is treated as a T-number. Invalid or unknown numbers are reported per item and do not fail the whole call. Uses 1 API request per number.

Match a list of company names (e.g. a customer list, sales list, or vendor master from a spreadsheet) to corporate numbers in one go (名寄せ). Each row gets a confidence: 'confident' (safe to use), 'review' (several close candidates; show them to the user), or 'unmatched'. Pass up to 50 names per call; adding a prefecture per row improves accuracy. The job usually finishes within seconds. If it is still running when this tool returns, call it again with the returned job_id (and no companies) to fetch the result; do not resubmit the list. Uses batch-row quota (Free plan: 50 rows per month). For a single company, bango_find_company is cheaper.