{
  "openapi": "3.1.0",
  "info": {
    "title": "Billeo Public Facts API",
    "version": "1.0.0",
    "description": "Read-only public facts published by Billeo. This API does not expose customer, CRM or authentication data."
  },
  "servers": [
    {
      "url": "https://www.billeo.es"
    }
  ],
  "paths": {
    "/api/billeo-facts.json": {
      "get": {
        "operationId": "getBilleoPublicFacts",
        "summary": "Get current public Billeo service facts",
        "responses": {
          "200": {
            "description": "Published plans, prices, limits and service facts",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/status.php": {
      "get": {
        "operationId": "getPublicApiStatus",
        "summary": "Check availability of the public facts API",
        "responses": {
          "200": {
            "description": "Public facts API is available",
            "content": {
              "application/health+json": {
                "schema": {
                  "type": "object",
                  "required": ["status", "checks"],
                  "properties": {
                    "status": { "type": "string", "enum": ["pass"] },
                    "checks": { "type": "object" }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Public facts file is unavailable or invalid"
          }
        }
      }
    }
  }
}