郵便番号ヘルパー API — 郵便番号・住所検索

▸ 試す

郵便番号

正引き: 郵便番号(7桁) → 住所（複数該当時は一覧）

住所

逆引き: 住所（部分一致） → 郵便番号

▸ エンドポイント

メソッド	パス	説明
GET	`/v1/postal-codes/{zipcode}`	正引き（郵便番号→住所、複数可）
GET	`/v1/postal-codes?pref=&city=&town=`	逆引き（住所→郵便番号、項目指定）
GET	`/v1/postal-codes?q={住所}`	逆引き（住所→郵便番号、フリーワード）
GET	`/v1/health`	稼働確認

レスポンスは { success, data, error, meta } の形式（JSON）。

$ curl /v1/postal-codes/1000001
{
  "success": true,
  "data": { "zipcode": "1000001", "addresses": [ { "pref": "東京都", "city": "千代田区", "town": "千代田" } ] },
  "error": null,
  "meta": { "source": "日本郵便 郵便番号データ", "sourceUpdatedAt": "2026-05-31" }
}

▸ ご利用にあたって

レート制限	IP単位（既定 120リクエスト/分）。超過時は `429` を返します。
CORS	ブラウザからの直接呼び出しに対応しています。
バージョン	パス `/v1`。認証は不要です。
出典	日本郵便郵便番号データダウンロード