データ・更新

要約: 各APIは公的機関の公開データ（日本郵便・国税庁・内閣府など）を出典としています。更新頻度はAPIごとに異なり、レスポンスの version フィールドで取得時点のバージョンを確認できます。データの誤りはサポート窓口へご報告ください。

データの出典はどこですか？この見出しへのリンク

郵便番号は日本郵便、法人番号は国税庁、適格請求書発行事業者は国税庁、祝日は内閣府など、APIごとに公的機関の公開データを参照しています。銀行情報のみ公的データではなく『角ちゃんのページ』様のデータを基に、ケンオール側で整形・更新検知を加えて配信しています。

出典側の更新頻度に合わせており、APIごとに異なります。郵便番号は毎月、法人番号は毎日、祝日は年次更新です。レスポンスの version フィールドで取得時点のデータバージョンを確認できます。

お問い合わせ窓口からご報告ください。いただいた報告を元に正しい住所を調査し、確認次第データを修正します。元データに誤りがある場合は出典機関の修正待ちとなりますが、ケンオール側の取り込み不備であれば最短当日中に修正します。

郵便番号は数字7桁ですが、0893443 のように頭がゼロの郵便番号が存在します。int型（数値型）で扱うと頭のゼロを正しく扱えないため、文字列型で取り扱うことを推奨します。

1つの郵便番号に複数の住所が紐づくケースがあるため、複数レコードを配列で返しています。「丁目を含む例」や「京都の通り名を含む例」などがこれに当たります。

1つの郵便番号は複数の住所に紐づくことがあり、配列の先頭が必ずしもその区域を代表するとは限りません。UI上どうしても1つだけを選んで補完しなければならない場合は、先頭の要素を選ぶとおおむね意図に沿った結果になります。

はい。大口事業所個別番号 (事業所の個別郵便番号) に対応しています。

大口事業所の個別番号の中には、日本郵便株式会社のデータに含まれないものもあります。インターネットへの掲載を希望されない事業所は、元データから除外されています。

市区町村APIで提供するデータは、郵便番号データをデータソースとして用いています。

いいえ。市区町村APIは郵便番号データに含まれる市区町村を用いており、総務省が提供する全国地方公共団体データはデータソースとしていません。そのため全国地方公共団体データとの同一性は保証しません。

郵便番号API・市区町村APIの city フィールドの最大文字数は、2022/04/28現在で10文字です（最長は「南都留郡富士河口湖町」）。データ更新でこの最長文字列は増減する場合があり、技術的に最大文字数を定義しているわけではありません。

エンタープライズプランにてダウンロードAPIを提供しています。詳しくは資料請求フォームからエンタープライズプランの資料請求をするか、営業へお問い合わせください。

はい、高層ビルの階層ごとの郵便番号も提供しています。

郵便番号APIは数字7桁（1000001）のみ受け付けており、100-0001 のようなハイフン入りには対応していません。入力の正規化はアプリケーションやクライアントライブラリが事前に行う想定です。

現在は最新の郵便番号データに含まれる住所にのみ対応しており、古い住所には対応していません。対応が必要な場合は営業へお問い合わせください。