{
  "openapi": "3.0.3",
  "info": {
    "title": "RapidXAI Public Content API",
    "version": "1.0.0",
    "description": "Read-only public data about RapidXAI's services, pricing, use cases, and FAQ. This is a lead-generation services company, not a self-serve SaaS platform — there is no authentication, no write operations, and no account system. To engage RapidXAI, use the consultation link returned by /api/consultation-link. An MCP server exposing the same data as tools is available at /api/mcp (see /.well-known/mcp/server-card.json).",
    "contact": { "name": "RapidXAI", "email": "shreyas@rapid-xai.com", "url": "https://rapidxai.com" },
    "license": { "name": "Public read-only API, no license required to consume" }
  },
  "servers": [{ "url": "https://rapidxai.com", "description": "Production" }],
  "paths": {
    "/api/services": {
      "get": {
        "operationId": "getServices",
        "summary": "List RapidXAI's core service lines",
        "description": "Returns the 3 real service lines RapidXAI offers: AI voice agents, an AI operating system, and high-converting websites.",
        "responses": {
          "200": {
            "description": "The 3 service lines",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ServicesResponse" },
                "example": {
                  "services": [
                    { "id": "ai-voice-agents", "title": "AI Voice Assistants", "description": "Human sounding agents that answer every call, qualify leads, and book appointments, in any language, around the clock.", "url": "https://rapidxai.com/voice-agents" }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/pricing": {
      "get": {
        "operationId": "getPricing",
        "summary": "Get public pricing plans",
        "description": "Returns RapidXAI's 3 published pricing plans (Pilot Deployment, Scale Plan, Enterprise) in USD. Exact pricing is still scoped on a consultation call, this is the published starting range.",
        "responses": {
          "200": {
            "description": "Pricing plans",
            "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PricingResponse" } } }
          }
        }
      }
    },
    "/api/use-cases": {
      "get": {
        "operationId": "getUseCases",
        "summary": "List deployable voice-agent use cases",
        "description": "Returns the 9 specific, named voice-agent use cases RapidXAI deploys (buyer qualification, cold database revival, COD confirmation, cart abandonment, clinic front desk, after-hours booking + dispatch, candidate screening, reservations, payment follow-up).",
        "responses": {
          "200": {
            "description": "Use cases",
            "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UseCasesResponse" } } }
          }
        }
      }
    },
    "/api/faq": {
      "get": {
        "operationId": "getFaq",
        "summary": "Get frequently asked questions",
        "description": "Returns the same FAQ content published on the RapidXAI homepage.",
        "responses": {
          "200": {
            "description": "FAQ entries",
            "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FaqResponse" } } }
          }
        }
      }
    },
    "/api/consultation-link": {
      "get": {
        "operationId": "getConsultationLink",
        "summary": "Get the real booking link for a consultation call",
        "description": "Every RapidXAI engagement starts with a human consultation call. This returns the real, live Calendly link. There is no automated booking endpoint — an agent must have the human it's acting for confirm the actual date and time before opening this link.",
        "responses": {
          "200": {
            "description": "Booking link",
            "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConsultationLinkResponse" } } }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ServicesResponse": {
        "type": "object",
        "properties": {
          "services": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": { "type": "string" },
                "title": { "type": "string" },
                "description": { "type": "string" },
                "url": { "type": "string", "format": "uri" }
              },
              "required": ["id", "title", "description", "url"]
            }
          }
        }
      },
      "PricingResponse": {
        "type": "object",
        "properties": {
          "currency": { "type": "string", "example": "USD" },
          "plans": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": { "type": "string" },
                "name": { "type": "string" },
                "summary": { "type": "string" },
                "audience": { "type": "string" },
                "startingPrice": {
                  "type": ["object", "null"],
                  "properties": {
                    "amount": { "type": "number" },
                    "currency": { "type": "string" },
                    "unit": { "type": "string", "enum": ["month", "minute"] },
                    "setupFee": { "type": ["number", "null"] }
                  }
                },
                "features": { "type": "array", "items": { "type": "string" } }
              },
              "required": ["id", "name", "summary", "audience", "features"]
            }
          },
          "note": { "type": "string" }
        }
      },
      "UseCasesResponse": {
        "type": "object",
        "properties": {
          "useCases": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "slug": { "type": "string" },
                "title": { "type": "string" },
                "summary": { "type": "string" },
                "url": { "type": "string", "format": "uri" }
              },
              "required": ["slug", "title", "summary", "url"]
            }
          }
        }
      },
      "FaqResponse": {
        "type": "object",
        "properties": {
          "faqs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "question": { "type": "string" },
                "answer": { "type": "string" }
              },
              "required": ["question", "answer"]
            }
          }
        }
      },
      "ConsultationLinkResponse": {
        "type": "object",
        "properties": {
          "url": { "type": "string", "format": "uri" },
          "durationMinutes": { "type": "integer" },
          "note": { "type": "string" }
        },
        "required": ["url", "durationMinutes"]
      },
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": { "type": "string" },
              "message": { "type": "string" },
              "status": { "type": "integer" }
            },
            "required": ["code", "message", "status"]
          }
        }
      }
    }
  }
}