{
  "openapi": "3.1.0",
  "info": {
    "title": "日本ピックルボールガイド Open Data API",
    "version": "2026-11-05",
    "summary": "日本ピックルボールガイド (日本, JPY) Read-Only Static Open Data API.",
    "contact": {
      "name": "日本ピックルボールガイド",
      "url": "https://pickleball.fashion/jp/feedback/"
    },
    "license": {
      "name": "Free to cite with attribution to pickleball.fashion",
      "url": "https://pickleball.fashion/jp/copyright/"
    }
  },
  "servers": [
    {
      "url": "https://pickleball.fashion",
      "description": "Production"
    }
  ],
  "paths": {
    "/jp/api/courts-full.json": {
      "get": {
        "operationId": "listCourtsFull_jp",
        "summary": "日本のピックルボールコート一覧",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/jp/api/courts.json": {
      "get": {
        "operationId": "listCourtsGeo_jp",
        "summary": "Courts Geo Index",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/jp/api/courts.csv": {
      "get": {
        "operationId": "downloadCourtsCsv_jp",
        "summary": "Courts CSV (UTF-8 BOM)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/jp/api/paddles.json": {
      "get": {
        "operationId": "listPaddles_jp",
        "summary": "ピックルボールパドル比較・スペック一覧",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/jp/api/apparel.json": {
      "get": {
        "operationId": "listApparel_jp",
        "summary": "ピックルボールウェア・シューズ・用品",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/jp/api/news.json": {
      "get": {
        "operationId": "listNews_jp",
        "summary": "ピックルボール最新ニュース（日本）",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/jp/api/events.json": {
      "get": {
        "operationId": "listEvents_jp",
        "summary": "ピックルボール大会・イベント日程（日本）",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/jp/api/learn.json": {
      "get": {
        "operationId": "listLearn_jp",
        "summary": "ピックルボールのルールと初心者入門ガイド",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Paddle": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "brand": {
            "type": "string"
          },
          "model": {
            "type": "string"
          },
          "currency": {
            "type": "string",
            "const": "JPY"
          },
          "price_min_jpy": {
            "type": [
              "integer",
              "null"
            ]
          },
          "price_max_jpy": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      }
    }
  }
}