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

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桁(チェックデジット)を確かめ、合わなければ入力の誤りとして返す。インボイス(適格請求書発行事業者)の登録の確認ではない。

get/v1/corporations/lookup

Request

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

Query parameters

corporate_numberstring required

13-digit corporate number, hyphens/spaces allowed / 法人番号(13桁。ハイフン・空白は任意)

Response

OK

resultobject required

The answer / 結果

sourceobject required

Source and verification / 出典と照合の状況

as_ofstring required

Reference date in Japan time (YYYY-MM-DD) / 基準日(日本時間)

notesstring[] required

Assumptions such as estimated values / 前提(見込みの値など)

flagsstring[] 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.

Changes

No recorded changes to this operation across all 1 revision of this API.