---
title: "Look up a Japanese corporate number / 法人番号から法人の情報"
method: GET
path: "/v1/corporations/lookup"
---

# Look up a Japanese corporate number / 法人番号から法人の情報

`GET /v1/corporations/lookup`

## Request

- Base URL: `https://biz.ossalt.jp`
- URL: `https://biz.ossalt.jp/v1/corporations/lookup`
- Auth: none declared

Look up a 13-digit Japanese corporate number (法人番号) in the National Tax Agency's monthly bulk data: name, furigana, English name, kind, registered address and postal code, assignment date, and closure (date, cause, successor) if the registry record was closed. The check digit (first digit) is verified first; a wrong check digit is reported as an input error. flags: `closed` (the registry record is closed — tell the user), `excluded_from_search`, `not_found`. This is not the invoice (qualified invoice issuer) registry. / 法人番号（13桁）から、名前・フリガナ・英語の名前・法人の種類・所在地・郵便番号・指定の日・閉鎖の日と事由・承継先を返す。国税庁の全件データ（月1回）。先頭の1桁（チェックデジット）を確かめ、合わなければ入力の誤りとして返す。インボイス（適格請求書発行事業者）の登録の確認ではない。

## Query parameters

- `corporate_number` string, required: 13-digit corporate number, hyphens/spaces allowed / 法人番号（13桁。ハイフン・空白は任意）

## Response `200`

OK

- Answer
  - `result` object, required: The answer / 結果
  - `source` object, required: Source and verification / 出典と照合の状況
  - `as_of` string, required: Reference date in Japan time (YYYY-MM-DD) / 基準日（日本時間）
  - `notes` string[], required: Assumptions such as estimated values / 前提（見込みの値など）
  - `flags` string[], required: `flags` holds machine-readable codes: `estimated` (a value is an estimate, e.g. a future equinox day — tell the user), `unverified` (year not yet checked against Cabinet Office data — tell the user), `assumes_current_era` (a future date written in the current era — tell the user), `outside_era` (the era date given is outside that era), `weekday_mismatch`, `closed` (the company's registry record is closed — tell the user), `excluded_from_search`, `truncated`, `not_found`, `exact_match_only`, `partial`, `ambiguous`, `city_not_found`, `ambiguous_city`.

## Other responses

- `400`: Invalid parameters / 入力の誤り
- `429`: Too many requests / 呼び出しが多すぎます
- `503`: Data unavailable / データを読めない

---

[API](https://skmtc.dev/ossalt/apis/japan-business-tools.md) · [All operations](https://skmtc.dev/ossalt/apis/japan-business-tools/llms.txt) · [OpenAPI document](https://skmtc.dev/ossalt/apis/japan-business-tools/revisions/8bb72a25e175?raw)