郵便番号検索APIの「大口事業所個別郵便番号データ」に関するお知らせ

平素よりケンオールをご利用いただきまして誠にありがとうございます。

このたび、ケンオールが取り扱う日本郵便提供のデータのうち、大口事業所個別郵便番号データを利用したAPIレスポンスにおいて、「郡」の情報が含まれていない不具合があることが判明し、修正しましたことをお知らせします。ご不便をおかけしましたことをお詫びいたします。

ケンオールでは、以下の2種類の日本郵便提供のマスターデータを取り扱っています。

1. 住所の郵便番号データ

   日本全国の住所と郵便番号の対応を提供するデータです。

2. 大口事業所個別郵便番号データ

   特定の事業所に割り当てられた個別の郵便番号を提供するデータです。

今回の不具合では、大口事業所個別郵便番号データを基にしたAPIレスポンスにおいて、「郡」の情報が正しく含まれておらず、以下のようなレスポンスを返しておりました。

修正前のレスポンスこの見出しへのリンク

{
  "version": "2025-06-30",
  "data": [
    {
      "jisx0402": "09343",
      "old_code": "32135",
      "postal_code": "3213597",
      "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": "120-1",
        "post_office": "茂木",
        "code_type": 0
      },
      "town_jukyohyoji": false,
      "update_status": 0,
      "update_reason": 0,
      "prefecture_roman": "Tochigi",
      "county": "芳賀郡",
      "county_kana": "ハガグン",
      "county_roman": "Haga",
      "city_without_county_and_ward": "茂木町",
      "city_without_county_and_ward_kana": "モテギマチ",
      "city_without_county_and_ward_roman": "Motegi",
      "city_ward": "",
      "city_ward_kana": "",
      "city_ward_roman": "",
      "city_roman": "Motegi, Haga",
      "town_roman": ""
    }
  ]
}

この不具合を修正し、「郡」の情報を含む正しいレスポンスを以下のように改善いたしました。

修正後のレスポンスこの見出しへのリンク

{
  "version": "2025-06-30",
  "data": [
    {
      "jisx0402": "09343",
      "old_code": "32135",
      "postal_code": "3213597",
      "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": "120-1",
        "post_office": "茂木",
        "code_type": 0
      },
      "town_jukyohyoji": false,
      "update_status": 0,
      "update_reason": 0,
      "prefecture_roman": "Tochigi",
      "county": "芳賀郡",
      "county_kana": "ハガグン",
      "county_roman": "Haga",
      "city_without_county_and_ward": "茂木町",
      "city_without_county_and_ward_kana": "モテギマチ",
      "city_without_county_and_ward_roman": "Motegi",
      "city_ward": "",
      "city_ward_kana": "",
      "city_ward_roman": "",
      "city_roman": "Motegi, Haga",
      "town_roman": ""
    }
  ]
}

なお、この修正はAPIレスポンスの構造を変更するものではありません。すべてのAPIバージョンに即時適用されており、追加の操作は不要です。

本事象はお客様からのご報告により明らかになりました。貴重なご報告に深く感謝申し上げます。

お客様からのご意見は、ケンオールのサービス向上に不可欠です。引き続きお気づきの点がございましたら、ぜひお知らせいただけますと幸いです。

引き続きケンオールをどうぞよろしくお願いいたします。