API Docs（β）

認証

全 /v1/* エンドポイントは Authorization: Bearer <API key> が必須です。無料APIキーは /developers から発行できます。レート制限はキー毎 60 req/min です。

エンドポイント

Method	Path	説明
GET	`/health`	ヘルスチェック（認証不要）
GET	`/v1/profile?q=\|muni_code=\|place_id=`	国土プロファイル1コール
GET	`/v1/munis/{muni_code}`	自治体プロファイル
GET	`/v1/munis/{muni_code}/land-prices`	地価時系列
GET	`/v1/munis/{muni_code}/zoning`	用途地域サマリ
GET	`/v1/license/resolve`	ライセンス台帳解決（fail-close）
GET	`/v1/license/ledger`	ライセンス台帳一覧
GET	`/v1/layers`	既知レイヤーカタログ
GET	`/openapi.json`	OpenAPI 3.1 スペック（認証不要）
POST	`/mcp`	MCP（streamable HTTP、Bearer認証）

レイヤーブロックのステータス

各レイヤーブロックは block_id（同一 layer_id 内の複数ブロックを区別、例: KSJ:A55 の zoning_youto=用途地域構成 / regulation_a55=それ以外の規制）と status を持ちます。unavailable_* の場合、data は必ず null です。

ok — 利用可能。ただし data が {"coverage": "none"} の場合は「ライセンス上は問題ないが対象データが無い」ことを意味します（例: 都市計画区域外の自治体には用途地域決定情報が存在しません）
unavailable_due_to_license — ライセンス未許諾（fail-close）
unavailable_due_to_not_ingested — 未収録レイヤー
experimental — 実験的（レイヤーブロック全体。将来推計人口 population_mesh が該当）

政令指定都市の行政区（例: 浜松市中央区）は /v1/munis/{muni_code} レスポンスの city_layer_scope が city_aggregate になり、用途地域・学校データは市集約コード（city_layer_muni_code）単位の値が返ります（区別のデータは国土数値情報側で配布されていないため）。

MCP

POST /mcp はstreamable HTTP（JSON-RPC 2.0）。ツール: get_land_profile / get_muni_profile / get_land_price_trends / get_zoning_summary / resolve_license / list_layers。