郵便番号 API

APIエンドポイント

郵便番号検索

curl https://postcode.teraren.com/postcodes.json

郵便番号

curl https://postcode.teraren.com/postcodes/{postcode.new}.json

都道府県

一覧

curl https://postcode.teraren.com/prefectures.json

都道府県

curl https://postcode.teraren.com/prefectures/{prefecture.code}.json

建物

一覧

curl https://postcode.teraren.com/buildings.json

都道府県

curl https://postcode.teraren.com/buildings/{building.name}.json

Offices

一覧

curl https://postcode.teraren.com/offices.json

postcodeオブジェクト

new郵便番号(7桁)
jis全国地方公共団体コード(JIS X0401、X0402)
old(旧)郵便番号(5桁)
prefecture_kana都道府県名
city_kana市区町村名
suburb_kana町域名
prefecture都道府県名
city市区町村名
suburb町域名
street_address小字名、丁目、番地等(漢字)
is_separated_suburb一町域が二以上の郵便番号で表される場合の表示  (「1」は該当、「0」は該当せず)
is_koaza小字毎に番地が起番されている町域の表示  (「1」は該当、「0」は該当せず)
is_chome丁目を有する町域の場合の表示 (「1」は該当、「0」は該当せず)
is_include_area一つの郵便番号で二以上の町域を表す場合の表示  (「1」は該当、「0」は該当せず)
status更新の表示(「0」は変更なし、「1」は変更あり、「2」廃止(廃止データのみ使用))
reason変更理由
0
変更なし
1
市政・区政・町政・分区・政令指定都市施行
2
住居表示の実施
3
区画整理
4
郵便区調整等
5
訂正
6
廃止(廃止データのみ使用)
postcode_type 郵便番号の種別。郵便局が住所用の郵便番号と事業所用の郵便番号を定義しているため。
area
住所
office
事業所
office大口事業所名(漢字)
office_kana大口事業所名(カナ)
handling_post_office取扱局(漢字)
post_type個別番号の種別の表示
multiple_numbers複数番号の有無

prefectureオブジェクト

code全国地方公共団体コード(JIS X0401、X0402)
name都道府県 漢字
name_e都道府県 ローマ字
name_h都道府県 ひらがな
name_k都道府県 カタカナ
area地方名
urlその都道府県にある郵便番号のURL

サンプルコード

郵便番号から地名

jQueryで郵便番号から住所へ変換する際のサンプルコード

郵便番号から名称を検索する場合のサンプルコードです