{
  "openapi": "3.1.0",
  "info": {
    "title": "NESkills Public Programme API",
    "version": "1.2.0",
    "description": "Authoritative, read-only public programme, fee, format and availability information for NESkills Center of Excellence. GET endpoints are served as static JSON snapshots for crawler reliability. The advisory recommendation endpoint does not create a lead, booking or payment."
  },
  "servers": [
    {
      "url": "https://neskillscenterofexcellence.com/api/v1"
    }
  ],
  "paths": {
    "/programmes": {
      "get": {
        "summary": "List programmes",
        "responses": {
          "200": {
            "description": "Programme list",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/programmes/{slug}": {
      "get": {
        "summary": "Get one programme",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Programme",
            "content": {
              "application/json": {}
            }
          },
          "404": {
            "description": "Not found"
          }
        }
      }
    },
    "/fees": {
      "get": {
        "summary": "Get current public fee rules",
        "responses": {
          "200": {
            "description": "Fee rules",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/formats": {
      "get": {
        "summary": "List delivery formats",
        "responses": {
          "200": {
            "description": "Formats",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/availability": {
      "get": {
        "summary": "Get publication status for availability",
        "responses": {
          "200": {
            "description": "Availability status",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/recommendations": {
      "post": {
        "summary": "Generate an advisory programme match",
        "description": "Advisory matching only. Does not store personal data, create an enquiry, book a session or take payment.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "situation": {
                    "type": "string"
                  },
                  "goal": {
                    "type": "string"
                  },
                  "audience": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Advisory matches",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/health": {
      "get": {
        "summary": "Minimal service health",
        "responses": {
          "200": {
            "description": "Healthy",
            "content": {
              "application/json": {}
            }
          },
          "503": {
            "description": "Degraded"
          }
        }
      }
    },
    "/": {
      "get": {
        "summary": "API discovery index",
        "responses": {
          "200": {
            "description": "API index and static fallbacks",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    }
  },
  "externalDocs": {
    "description": "NESkills AI-readable site summary",
    "url": "https://neskillscenterofexcellence.com/llms.txt"
  },
  "x-agent-policy": "https://neskillscenterofexcellence.com/agent-policy.json",
  "x-static-fallbacks": {
    "programmes": "https://neskillscenterofexcellence.com/api/v1/programmes.json",
    "fees": "https://neskillscenterofexcellence.com/api/v1/fees.json",
    "formats": "https://neskillscenterofexcellence.com/api/v1/formats.json",
    "availability": "https://neskillscenterofexcellence.com/api/v1/availability.json",
    "health": "https://neskillscenterofexcellence.com/api/v1/health.json"
  }
}