Skip to main content

市区町村API

GET /v1/cities/:都道府県コード​

郵便番号データ内に存在する都道府県・市区町村のうち、指定された都道府県内の全ての市区町村の一覧を返します。

リソースURL​

https://api.kenall.jp/v1/cities/:都道府県コード

パラメーター​

名前型必須かどうか説明例
:都道府県コードstring必須JIS X 0401 で定義された、都道府県コード。"01"

レスポンス​

{
  "version": "2021-02-26",
  "data": [
    {
      "jisx0402": "13308",
      "prefecture_code": "13",
      "city_code": "308",
      "prefecture_kana": "トウキョウト",
      "city_kana": "ニシタマグンオクタママチ",
      "prefecture": "東京都",
      "city": "西多摩郡奥多摩町",
      "prefecture_roman": "Tokyo",
      "city_roman": "Okutama, Nishitama",
      "county": "西多摩郡",
      "county_kana": "ニシタマグン",
      "county_roman": "Nishitama",
      "city_without_county_and_ward": "奥多摩町",
      "city_without_county_and_ward_kana": "オクタママチ",
      "city_without_county_and_ward_roman": "Okutama"
    },
    ...
  ]
}

レスポンスのデータは以下のような構成になっています。

名前型説明例
versionstringデータのバージョン番号。YYYY-MM-DD形式の、データ作成日付となっている。
dataarray市区町村レコードの配列

data配列内の市区町村レコードは以下のような構成になっています。

名前型説明例
jisx0402string全国地方公共団体コード(JIS X 0401、X 0402)"13308"
prefecture_codestring都道府県コード(JIS X 0401)"13"
city_codestring市区町村コード(JIS X 0402)"308"
prefecturestring都道府県名"東京都"
prefecture_kanastring都道府県名(全角カナ)"トウキョウト"
prefecture_romanstring都道府県名(ローマ字)"Tokyo"
citystring市区町村名"西多摩郡奥多摩町"
city_kanastring市区町村名(全角カナ)"ニシタマグンオクタママチ"
city_romanstring市区町村名(ローマ字)"Okutama, Nishitama"
countystring郡名"西多摩郡"
county_kanastring郡名(全角カナ)"ニシタマグン"
county_romanstring郡名(ローマ字)"Nishitama"
city_without_county_and_wardstring地方自治体の市区町村のうち、郡及び政令指定都市の行政区を除いたもの"奥多摩町"
city_without_county_and_ward_kanastring地方自治体の市区町村のうち、郡及び政令指定都市の行政区を除いたもの(全角カナ)"オクタママチ"
city_without_county_and_ward_romanstring地方自治体の市区町村のうち、郡及び政令指定都市の行政区を除いたもの(ローマ字)"Okutama"

都道府県コード​

都道府県コードは、JIS X 0401 で定義されている、都道府県毎に付与された数字2桁のコードです。

市区町村APIを使う際に必要になりますので、以下のJSONコードをご利用ください。

{
   "北海道":"01",
   "青森県":"02",
   "岩手県":"03",
   "宮城県":"04",
   "秋田県":"05",
   "山形県":"06",
   "福島県":"07",
   "茨城県":"08",
   "栃木県":"09",
   "群馬県":"10",
   "埼玉県":"11",
   "千葉県":"12",
   "東京都":"13",
   "神奈川県":"14",
   "新潟県":"15",
   "富山県":"16",
   "石川県":"17",
   "福井県":"18",
   "山梨県":"19",
   "長野県":"20",
   "岐阜県":"21",
   "静岡県":"22",
   "愛知県":"23",
   "三重県":"24",
   "滋賀県":"25",
   "京都府":"26",
   "大阪府":"27",
   "兵庫県":"28",
   "奈良県":"29",
   "和歌山県":"30",
   "鳥取県":"31",
   "島根県":"32",
   "岡山県":"33",
   "広島県":"34",
   "山口県":"35",
   "徳島県":"36",
   "香川県":"37",
   "愛媛県":"38",
   "高知県":"39",
   "福岡県":"40",
   "佐賀県":"41",
   "長崎県":"42",
   "熊本県":"43",
   "大分県":"44",
   "宮崎県":"45",
   "鹿児島県":"46",
   "沖縄県":"47"
}