郵便番号→住所API リファレンス

{
  "version": "2022-09-30",
  "data": [
    {
      "jisx0402": "13101",
      "old_code": "100",
      "postal_code": "1000001",
      "prefecture_kana": "トウキョウト",
      "city_kana": "チヨダク",
      "town_kana": "チヨダ",
      "town_kana_raw": "チヨダ",
      "prefecture": "東京都",
      "city": "千代田区",
      "town": "千代田",
      "koaza": "",
      "kyoto_street": "",
      "building": "",
      "floor": "",
      "town_partial": false,
      "town_addressed_koaza": false,
      "town_chome": false,
      "town_multi": false,
      "town_raw": "千代田",
      "corporation": null,
      "town_jukyohyoji": false,
      "update_status": 0,
      "update_reason": 0,
      "prefecture_roman": "Tokyo",
      "county": "",
      "county_kana": "",
      "county_roman": "",
      "city_without_county_and_ward": "千代田区",
      "city_without_county_and_ward_kana": "チヨダク",
      "city_without_county_and_ward_roman": "Chiyoda-ku",
      "city_ward": "",
      "city_ward_kana": "",
      "city_ward_roman": "",
      "city_roman": "Chiyoda-ku",
      "town_roman": "Chiyoda"
    }
  ]
}

📌 2022-11-01 で prefecture_roman / city_roman / county_roman / city_without_county_and_ward 系 / city_ward 系 / town_roman のローマ字・郡・行政区フィールドが追加されました。2023-09-01 と同等のフィールド構成です。

{
  "version": "2021-06-30",
  "data": [
    {
      "jisx0402": "13101",
      "old_code": "100",
      "postal_code": "1000001",
      "prefecture_kana": "トウキョウト",
      "city_kana": "チヨダク",
      "town_kana": "チヨダ",
      "town_kana_raw": "チヨダ",
      "prefecture": "東京都",
      "city": "千代田区",
      "town": "千代田",
      "koaza": "",
      "kyoto_street": "",
      "building": "",
      "floor": "",
      "town_partial": false,
      "town_addressed_koaza": false,
      "town_chome": false,
      "town_multi": false,
      "town_raw": "千代田",
      "corporation": null
    }
  ]
}

⚠️ ローマ字・郡・政令指定都市行政区・town_jukyohyoji・update_status / update_reason は未提供。横浜市中区などを表示する用途や住居表示判定が必要な用途では 2022-11-01 以降の利用を推奨します。

{
  "version": "2022-09-30",
  "data": [
    {
      "jisx0402": "13104",
      "old_code": "16001",
      "postal_code": "1638001",
      "prefecture_kana": "トウキョウト",
      "city_kana": "シンジュクク",
      "town_kana": "",
      "town_kana_raw": "",
      "prefecture": "東京都",
      "city": "新宿区",
      "town": "西新宿",
      "koaza": "",
      "kyoto_street": "",
      "building": "",
      "floor": "",
      "town_partial": false,
      "town_addressed_koaza": false,
      "town_chome": false,
      "town_multi": false,
      "town_raw": "西新宿",
      "corporation": {
        "name": "東京都庁",
        "name_kana": "トウキヨウトチヨウ",
        "block_lot": "２丁目８－１",
        "block_lot_num": "2-8-1",
        "post_office": "新宿",
        "code_type": 0
      },
      "town_jukyohyoji": true,
      "update_status": 0,
      "update_reason": 0,
      "prefecture_roman": "Tokyo",
      "county": "",
      "county_kana": "",
      "county_roman": "",
      "city_without_county_and_ward": "新宿区",
      "city_without_county_and_ward_kana": "シンジュクク",
      "city_without_county_and_ward_roman": "Shinjuku-ku",
      "city_ward": "",
      "city_ward_kana": "",
      "city_ward_roman": "",
      "city_roman": "Shinjuku-ku",
      "town_roman": ""
    }
  ]
}

📌 2022-11-01 で corporation 含むレコードもローマ字・郡・行政区フィールドに対応。2023-09-01 と同等です。

{
  "version": "2022-01-31",
  "data": [
    {
      "jisx0402": "13104",
      "old_code": "16001",
      "postal_code": "1638001",
      "prefecture_kana": "",
      "city_kana": "",
      "town_kana": "",
      "town_kana_raw": "",
      "prefecture": "東京都",
      "city": "新宿区",
      "town": "西新宿",
      "koaza": "",
      "kyoto_street": "",
      "building": "",
      "floor": "",
      "town_partial": false,
      "town_addressed_koaza": false,
      "town_chome": false,
      "town_multi": false,
      "town_raw": "西新宿",
      "town_jukyohyoji": true,
      "update_status": 0,
      "update_reason": 0,
      "corporation": {
        "name": "東京都庁",
        "name_kana": "トウキヨウトチヨウ",
        "block_lot": "２丁目８－１",
        "block_lot_num": "2-8-1",
        "post_office": "新宿",
        "code_type": 0
      }
    }
  ]
}

⚠️ ローマ字・郡・政令指定都市行政区関連フィールドは未提供。カナフィールドも大口事業所個別番号レコードでは空文字 ("") が返ります。

2023-09-01 と同じ 35 フィールド構成です。ローマ字・郡・行政区・town_roman・town_jukyohyoji・update_status / update_reason はすべてこのバージョンから提供開始。

本番 kenall.jp の field table も 2023-09-01 と内容が同一です。

⚠️ ローマ字 (prefecture_roman系・city_roman系・town_roman)、郡 (county系)、政令指定都市行政区 (city_ward系・city_without_county_and_ward系)、住居表示判定 (town_jukyohyoji)、更新ステータス (update_status / update_reason) はすべて未提供。