{
  "openapi": "3.1.0",
  "info": {
    "title": "Pickleball Việt Nam Open Data API",
    "version": "2026-11-05",
    "summary": "Pickleball Việt Nam (Việt Nam, VND) Read-Only Static Open Data API.",
    "contact": {
      "name": "Pickleball Việt Nam",
      "url": "https://pickleball.fashion/vn/feedback/"
    },
    "license": {
      "name": "Free to cite with attribution to pickleball.fashion",
      "url": "https://pickleball.fashion/vn/copyright/"
    }
  },
  "servers": [
    {
      "url": "https://pickleball.fashion",
      "description": "Production"
    }
  ],
  "paths": {
    "/vn/api/courts-full.json": {
      "get": {
        "operationId": "listCourtsFull_vn",
        "summary": "Danh sách sân pickleball tại Việt Nam",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/vn/api/courts.json": {
      "get": {
        "operationId": "listCourtsGeo_vn",
        "summary": "Courts Geo Index",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/vn/api/courts.csv": {
      "get": {
        "operationId": "downloadCourtsCsv_vn",
        "summary": "Courts CSV (UTF-8 BOM)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/vn/api/paddles.json": {
      "get": {
        "operationId": "listPaddles_vn",
        "summary": "So sánh thông số & giá vợt pickleball tại Việt Nam",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/vn/api/apparel.json": {
      "get": {
        "operationId": "listApparel_vn",
        "summary": "Giày sân cứng, trang phục & phụ kiện pickleball",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/vn/api/news.json": {
      "get": {
        "operationId": "listNews_vn",
        "summary": "Tin tức pickleball Việt Nam",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/vn/api/events.json": {
      "get": {
        "operationId": "listEvents_vn",
        "summary": "Lịch giải đấu & sự kiện pickleball Việt Nam",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/vn/api/learn.json": {
      "get": {
        "operationId": "listLearn_vn",
        "summary": "Luật chơi pickleball & cẩm nang cho người mới",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Paddle": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "brand": {
            "type": "string"
          },
          "model": {
            "type": "string"
          },
          "currency": {
            "type": "string",
            "const": "VND"
          },
          "price_min_vnd": {
            "type": [
              "integer",
              "null"
            ]
          },
          "price_max_vnd": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      }
    }
  }
}