市区町村API リファレンス

エンドポイント一覧この見出しへのリンク

共通仕様この見出しへのリンク

GET /v1/cities/{都道府県コード}この見出しへのリンク

リソースURLこの見出しへのリンク

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

パスパラメータこの見出しへのリンク

curl サンプルこの見出しへのリンク

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.kenall.jp/v1/cities/13

レスポンス例 (東京都)この見出しへのリンク

⇩ 利用中のAPIバージョンを選択してください。市区町村APIでは郡・行政区分解フィールドは 2023-09-01 から追加 (postal-code API とは進化タイミングが異なります)。

{
  "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"
    }
  ]
}

{
  "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"
    }
  ]
}

{
  "version": "2021-02-26",
  "data": [
    {
      "jisx0402": "13308",
      "prefecture_code": "13",
      "city_code": "308",
      "prefecture_kana": "トウキョウト",
      "city_kana": "ニシタマグンオクタママチ",
      "prefecture": "東京都",
      "city": "西多摩郡奥多摩町"
    }
  ]
}

レスポンス・トップレベルフィールドこの見出しへのリンク

data 配列内・市区町村レコードのフィールド仕様この見出しへのリンク

⇩ APIバージョンで返却されるフィールドが異なります。本番kenall.jpと同じ進化タイミング (15 / 9 / 7 フィールド)。

JIS X 0401 都道府県コード一覧 (47件)この見出しへのリンク

パスパラメータ {都道府県コード} に指定する2桁コードです。文字列型で先頭ゼロを保ったまま送信してください (例: "01")。

HTTP ステータス・エラーこの見出しへのリンク

共通エラー仕様は API共通仕様 — HTTPステータスコード を参照してください。

SDK で呼び出すこの見出しへのリンク

JavaScript SDKこの見出しへのリンク

import { KENALL } from '@ken-all/kenall';
const api = new KENALL('YOUR_API_KEY');
 
// 都道府県 → 市区町村 カスケード
const tokyoCities = await api.getCities('13');
console.log(tokyoCities.data.map(c => c.city)); // => ["千代田区", "中央区", ...]

Python (都道府県セレクト連動)この見出しへのリンク

import os, requests
HEADERS = {"Authorization": f"Token {os.environ['KENALL_API_KEY']}"}
 
def get_cities(pref_code):
    """都道府県コード ('01'〜'47') を渡すと、配下の市区町村リストを返す"""
    res = requests.get(f"https://api.kenall.jp/v1/cities/{pref_code}", headers=HEADERS, timeout=10)
    res.raise_for_status()
    return res.json()["data"]
 
# 例: 東京都の市区町村一覧
for city in get_cities("13"):
    print(city["jisx0402"], city["city"])

注意事項・制限事項この見出しへのリンク

都道府県コードの型についてこの見出しへのリンク

JIS X 0401 の都道府県コードには先頭ゼロのもの ("01"〜"09") が含まれます。必ず文字列型で扱ってください。数値型では先頭ゼロが失われ、不正なリクエストとなります。

「市区町村」カラムの郡含みについてこの見出しへのリンク

city フィールドは「西多摩郡奥多摩町」のように郡名を含む形式です。純粋な市区町村名のみが必要な場合は city_without_county_and_ward を使ってください。

政令指定都市の行政区この見出しへのリンク

本APIは政令指定都市の行政区を返しません (例: 横浜市の中区・西区など)。行政区を含む完全な住所が必要な場合は 郵便番号→住所API を利用してください。

このAPIに関する技術FAQこの見出しへのリンク

関連リファレンスこの見出しへのリンク

• ⚠️ 既知の問題 (このAPIに該当する制約・破壊的変更)
• API共通仕様 — Token認証 / HTTPステータス / バージョニング
• 郵便番号→住所API — 郵便番号からピンポイント住所
• 郵便番号データダウンロードAPI — マスタ一括取得
• 住所→郵便番号API — 表記ゆれ住所の正規化
• OpenAPI スキーマ (YAML): 2023-09-01 / 2024-01-01 / 2025-01-01

外部参考リソースこの見出しへのリンク

• 総務省『全国地方公共団体コード (JIS X 0401・X 0402)』

最終更新: 2026-07-15