{
  "openapi": "3.0.0",
  "info": {
    "title": "Conference Venues SA API",
    "description": "Public API for searching and retrieving conference venue information across South Africa.",
    "version": "1.0.0",
    "contact": { "email": "info@conferencevenues.co.za" }
  },
  "servers": [{ "url": "https://conferencevenues.co.za" }],
  "paths": {
    "/api/venues": {
      "get": {
        "operationId": "listVenues",
        "summary": "List and filter conference venues",
        "parameters": [
          { "name": "province", "in": "query", "schema": { "type": "string", "enum": ["gauteng","western-cape","kwazulu-natal","eastern-cape","free-state","north-west","mpumalanga","limpopo","northern-cape"] }, "description": "Filter by province" },
          { "name": "city", "in": "query", "schema": { "type": "string" }, "description": "Filter by city name" },
          { "name": "type", "in": "query", "schema": { "type": "string", "enum": ["hotel","conference-centre","lodge","guest-house","resort","wine-estate","casino","country-club","university","estate","co-working-space","community-centre"] }, "description": "Filter by venue type" },
          { "name": "capacity", "in": "query", "schema": { "type": "integer" }, "description": "Minimum capacity required" },
          { "name": "amenity", "in": "query", "schema": { "type": "string" }, "description": "Filter by amenity (e.g. wifi, parking, catering, accommodation)" },
          { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 20 }, "description": "Results per page (max 100)" },
          { "name": "offset", "in": "query", "schema": { "type": "integer", "default": 0 }, "description": "Pagination offset" }
        ],
        "responses": { "200": { "description": "List of venues matching filters" } }
      }
    },
    "/api/venues/{slug}": {
      "get": {
        "operationId": "getVenue",
        "summary": "Get full details for a specific venue",
        "parameters": [
          { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Venue URL slug" }
        ],
        "responses": { "200": { "description": "Full venue details including contact, amenities, images, rooms" } }
      }
    },
    "/api/search": {
      "get": {
        "operationId": "searchVenues",
        "summary": "Full-text search across venue names, descriptions, and locations",
        "parameters": [
          { "name": "q", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Search query (e.g. 'cape town hotel wifi')" }
        ],
        "responses": { "200": { "description": "Search results ranked by relevance" } }
      }
    },
    "/api/provinces": {
      "get": {
        "operationId": "listProvinces",
        "summary": "Get summary of all provinces with venue counts",
        "responses": { "200": { "description": "Province list with counts" } }
      }
    }
  }
}