郵便局

郵便番号・デジタルアドレス for Biz

郵便番号・デジタルアドレスAPI

住所も、ビジネス情報も、1つのAPIで。

日本郵便公式・無料・メンテ不要
2026/03/18以前にご登録のお客さまへ

ビジネスデジタルアドレス対応の「郵便番号・デジタルアドレスAPI(ver2.0)」の提供を開始しました

郵便番号・個人向けデジタルアドレスからの住所返却に加え、新機能として、ビジネスデジタルアドレスから「法人・個人事業主」の住所、電話番号、法人番号などのビジネス情報も返却できるようになりました。
本APIは、2026/03/19よりご利用いただける新しい「郵便番号・デジタルアドレス for Biz」で提供しています。
新規登録のうえ、ぜひご利用ください。

NEW! ビジネスデジタルアドレス

郵便番号・デジタルアドレスAPIの特徴

1つのAPIで、郵便番号とデジタルアドレスのそれぞれから住所等を取得できるAPIです。

郵便番号

郵便番号

郵便番号から都道府県・市区町村・町域を取得できます。


日本郵便から公式郵便番号データAPI登場

  1. 1. マスタメンテナンス更新にかかる手間・コストを削減

    郵便番号データCSVをデータソースとしたAPIが無料でご利用いただけます。
    マスターデータの更新にあわせてタイムリーに反映します。

  2. 2. ローマ字返却により在日・訪日外国人向け海外事業にも対応可能

    本APIは、住所データを漢字・カナに加えてローマ字でも返却、またフリーワード検索が可能です。
    越境ビジネスや、外国籍の方向けのサービスにもご利用いただけます。
    ※事業所個別番号については、漢字・カナのみに対応しています。

  3. 3. WEB入力に適した仕様でユーザー体験を向上

    郵便番号データCSVのままでは、取り扱いづらい"以下に掲載のない場合"や、"京都の通り名"などの特有の表現をWEB入力に最適化して返却します。
    ※返却仕様の詳細は、リファレンスページにてご案内しています。

デジタルアドレス

デジタルアドレスヘルプ

デジタルアドレスから郵便番号含む住所全文を取得できます。

ビジネスデジタルアドレスヘルプ新機能

ビジネスデジタルアドレスから郵便番号含む住所全文やビジネス情報を取得できます。


デジタルアドレスでさらに簡便な住所管理を実現

  1. 1. WEBでの住所入力をさらに便利に

    省かれがちな建物名や部屋番号も手間なく入力いただけます。

  2. 2. 郵便番号検索と一緒にスムーズに導入

    郵便番号と同じ7桁のため、既存の郵便番号入力欄を英数字入力に対応するだけで導入が可能です。

  3. 3. 住所の名寄せに貢献

    デジタルアドレス・ビジネスデジタルアドレスをキーにすることで、複数サービスに横断する住所の名寄せにご活用いただけます。

  4. 4. 住所の最新化に貢献

    デジタルアドレスをキーとして保管いただくことでユーザーの転居後住所の取得が容易になります。

郵便番号・デジタルアドレスAPIの導入

郵便番号・デジタルアドレスAPIのご利用は無料です。
テスト用API情報・APIリファレンス・利用ガイドライン・リリースノートはログイン後に参照可能です。

  • スコープ一覧

    郵便番号・デジタルアドレスAPIのスコープ一覧です。

    スコープ名称説明
    searchcodeデジタルアドレス/郵便番号/事業所個別番号/から該当する住所とビジネス情報を返却
    addresszip住所から該当する郵便番号を返却
    tokenAPI利用トークンを返却
  • 権限

    本サービスは、組織単位でご利用いただくサービスです。
    代表者が組織を登録し、招待機能を利用してメンバーを追加できます。
    ※詳しくはログイン後のダッシュボード内にある「権限について」をご参照ください。

    権限区分説明
    組織権限「組織管理者」と「一般ユーザー」の2種類
    サービス権限「API管理者」や「ビジネスデジタルアドレス管理者」などのサービスに対しての管理者と「参照ユーザー」の2種類
  • セキュリティ基準

    1. データ暗号化

      当社のAPIはAES-256を使用し、すべての通信はTLS 1.2以上で暗号化しています。

    2. API利用ログの保存・監査

      全リクエストのログを一定期間保存し、異常アクセスを監視・監査しています。

    3. WAFによる異常検知

      Web Application Firewall(WAF)を導入し、不正アクセスやDDoS攻撃をリアルタイムで検知・ブロックします。

    4. APIバージョン管理

      安定した運用のため、APIバージョンごとにサポートポリシーを定めています。

  • 接続要件

    1. 認証とアクセス管理

      当APIでは、OAuth 2.0 / OpenID Connect による認証・認可をサポートしています。これにより、安全なユーザー認証とアクセス制御が可能になります。

    2. 安全な通信の確保

      APIとの通信はすべて HTTPS(TLS 1.2以上)を使用して暗号化されており、データの機密性と完全性を保護します。

    3. リクエスト頻度の管理(レートリミット)

      サービスの安定運用のため、一定時間内のリクエスト数に制限(レートリミット)を設けています。

サービスご利用の流れ

  1. STEP 1

    ゆうIDを登録

    ゆうIDを登録

    郵便番号・デジタルアドレス for Bizのご利用にはゆうIDが必要です。

  2. STEP2

    郵便番号・デジタルアドレス for Bizの登録

    郵便番号・デジタルアドレス for Bizの登録

    郵便番号・デジタルアドレス for Bizでビジネスアカウント・組織を登録します。

  3. STEP3

    郵便番号・デジタルアドレスAPIの利用登録

    郵便番号・デジタルアドレスAPIの利用登録

    利用規約への同意と利用システムを登録します。

  4. STEP4

    ご利用スタート

    ご利用スタート

    郵便番号・デジタルアドレスAPIが利用できます。

住所も、ビジネス情報も、1つのAPIで。

サービスご利用上の注意事項

本APIの第三者企業への提供は利用規約で禁じられています。提供を行う必要がある場合は、各システムを登録する際にAPI組込みシステムの第三者提供特約への同意をお願いします。

○特約対象外

[日本郵便]→APIの提供→[本APIご利用の事業者A]→住所に変換→[エンドユーザー]→郵便番号・デジタルアドレスの入力→[本APIご利用の事業者A]→ご利用登録→[日本郵便][日本郵便]→APIの提供→[本APIご利用の事業者A]→住所に変換→[エンドユーザー]→郵便番号・デジタルアドレスの入力→[本APIご利用の事業者A]→ご利用登録→[日本郵便]

△
特約対象
※特約同意が必要です。

[日本郵便]→APIの提供→[本APIご利用の事業者A]→API組込みシステムの提供→[第三者の事業者B]→事業者AのAPI認証キーを利用して住所に変換→[エンドユーザー]→郵便番号・デジタルアドレスの入力→[第三者の事業者B]→システムの利用→[本APIご利用の事業者A]→ご利用登録→[日本郵便][日本郵便]→APIの提供→[本APIご利用の事業者A]→API組込みシステムの提供→[第三者の事業者B]→事業者AのAPI認証キーを利用して住所に変換→[エンドユーザー]→郵便番号・デジタルアドレスの入力→[第三者の事業者B]→システムの利用→[本APIご利用の事業者A]→ご利用登録→[日本郵便]

ユースケース:SaaS事業者

SaaS事業者が、自社の顧客に対して「API組込み済みCRM」を提供し、顧客がCRMのAPIをそのまま利用する場合

[本APIご利用のSaaS事業者(API組込み済みCRM)]→CRMの提供→[顧客]→住所に変換→[エンドユーザー]→住所を入力する際に郵便番号・デジタルアドレスを入力→[顧客]→CRMの利用→[本APIご利用のSaaS事業者(API組込み済みCRM)][本APIご利用のSaaS事業者(API組込み済みCRM)]→CRMの提供→[顧客]→住所に変換→[エンドユーザー]→住所を入力する際に郵便番号・デジタルアドレスを入力→[顧客]→CRMの利用→[本APIご利用のSaaS事業者(API組込み済みCRM)]

※「本APIご利用の事業者」とは、本サービスの利用規約に同意いただいた事業者を指します。


よくあるご質問・お問い合わせ

郵便番号・デジタルアドレス for Bizとは何ですか?

郵便番号・デジタルアドレスを起点とするサービスを、法人・個人事業主のお客さま向けに提供しています。 「郵便番号・デジタルアドレスAPI」「デジタルアドレスから住所を検索」「ビジネスデジタルアドレス」等の機能をご利用いただけます。

新規登録する際、ゆうIDは法人・個人のどちらで登録すればよいですか?

郵便番号・デジタルアドレス for Bizにおいて、ゆうIDは各ユーザーの認証にのみ使用されます。 新規登録の際は担当者さまごとにゆうIDを登録いただくか、すでにお持ちの場合は個人のゆうIDをご利用ください。 なお、当サイトでは1つの法人につき1つの組織、担当者1名につき1つのビジネスアカウントを登録いただけます。

社内の部署ごとに組織を登録することはできますか?

郵便番号・デジタルアドレス for Bizでは、1つの法人ごとに登録できる「組織」は1つです。 なお、組織に他のユーザーを招待することで、複数のユーザーでダッシュボードを共有することができます。