{
  "openapi": "3.1.0",
  "info": {
    "title": "QCE Global Agent API",
    "version": "1.0.0",
    "description": "Machine-readable agent endpoints for QCE Global — B2A discovery, offers, pricing, and programmatic inquiry. Token-efficient payloads with zero UI state.",
    "contact": {
      "email": "team@qceglobal.com"
    },
    "license": {
      "name": "Proprietary"
    }
  },
  "servers": [
    {
      "url": "https://qceglobal.com",
      "description": "Production"
    }
  ],
  "paths": {
    "/api/agent/v1/business-info.json": {
      "get": {
        "operationId": "getBusinessInfo",
        "summary": "Full business profile (ADO)",
        "tags": [
          "discovery"
        ],
        "responses": {
          "200": {
            "description": "Business profile",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/agent/v1/offers.json": {
      "get": {
        "operationId": "getOffers",
        "summary": "Complete offer catalog with pricing and deliverables (ADO/ARO)",
        "tags": [
          "commerce"
        ],
        "responses": {
          "200": {
            "description": "Offer catalog",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/agent/v1/pricing.json": {
      "get": {
        "operationId": "getPricing",
        "summary": "Flat pricing array for quick-check agents (ARO)",
        "tags": [
          "commerce"
        ],
        "responses": {
          "200": {
            "description": "Pricing tiers",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/agent/v1/policies.json": {
      "get": {
        "operationId": "getPolicies",
        "summary": "Refund/cancellation logic matrices + SLA + compliance proofs (ARO)",
        "tags": [
          "governance"
        ],
        "responses": {
          "200": {
            "description": "Policy matrices",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/faq/data.json": {
      "get": {
        "operationId": "getFaqData",
        "summary": "Un-truncated FAQ knowledge base (AEO/GEO/ADO)",
        "tags": [
          "knowledge"
        ],
        "responses": {
          "200": {
            "description": "FAQ knowledge node",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/agent/v1/inquiry": {
      "post": {
        "operationId": "submitInquiry",
        "summary": "Programmatic inquiry with deterministic JSON confirmation (AEXO)",
        "tags": [
          "execution"
        ],
        "security": [
          {
            "AgentKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "contact_email",
                  "message"
                ],
                "properties": {
                  "contact_email": {
                    "type": "string",
                    "format": "email"
                  },
                  "contact_name": {
                    "type": "string"
                  },
                  "company": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  },
                  "seats_needed": {
                    "type": "number"
                  },
                  "deployment_preference": {
                    "type": "string",
                    "enum": [
                      "qce-hosted",
                      "customer-cloud",
                      "on-prem",
                      "unsure"
                    ]
                  },
                  "intent": {
                    "type": "string",
                    "enum": [
                      "platform-tier",
                      "onboarding",
                      "enterprise-sovereign",
                      "partnership"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Inquiry accepted",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Validation error"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "AgentKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Agent-Key"
      }
    }
  }
}