{
 "openapi": "3.1.0",
 "info": {
  "title": "Qadiva agent API — wholesale glassware (UAE & GCC)",
  "version": "1.0.0",
  "description": "For AI agents. Qadiva sells glassware wholesale to hotels, restaurants, caterers and distributors in the UAE and GCC, made to order and shipped to the buyer's port. No prices are returned; a quote request reaches Qadiva's inbox and gets a written quote per piece. Same tools over MCP at https://qadiva.com/mcp. No API key.",
  "contact": {
   "name": "Qadiva",
   "email": "sales@qadiva.com",
   "url": "https://qadiva.com/agents/"
  }
 },
 "servers": [
  {
   "url": "https://qadiva.com/api/v1"
  }
 ],
 "paths": {
  "/glassware": {
   "get": {
    "operationId": "listGlassware",
    "summary": "8 core references with dimensions (filter by q, category, min_ml, max_ml)",
    "parameters": [
     {
      "name": "q",
      "in": "query",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "category",
      "in": "query",
      "schema": {
       "type": "string",
       "enum": [
        "Stemware",
        "Tumblers",
        "Serveware"
       ]
      }
     },
     {
      "name": "min_ml",
      "in": "query",
      "schema": {
       "type": "number"
      }
     },
     {
      "name": "max_ml",
      "in": "query",
      "schema": {
       "type": "number"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Pieces",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/glassware/{ref}": {
   "get": {
    "operationId": "getPiece",
    "summary": "One piece by reference",
    "parameters": [
     {
      "name": "ref",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "enum": [
        "L3721",
        "L6011",
        "W15236",
        "C1134",
        "CH012",
        "C2338",
        "YZ02",
        "MF1300ST"
       ]
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Piece",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "Unknown",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/terms": {
   "get": {
    "operationId": "getTerms",
    "summary": "How buying works",
    "responses": {
     "200": {
      "description": "Terms",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/quote": {
   "post": {
    "operationId": "requestQuote",
    "summary": "Send a quote request for a business buyer (with consent). Reaches the same inbox as the website form.",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "required": [
         "buyer",
         "items"
        ],
        "properties": {
         "items": {
          "type": "array",
          "minItems": 1,
          "maxItems": 30,
          "items": {
           "type": "object",
           "properties": {
            "ref": {
             "type": "string"
            },
            "description": {
             "type": "string"
            },
            "quantity": {
             "type": "integer",
             "minimum": 0
            }
           }
          }
         },
         "buyer": {
          "type": "object",
          "required": [
           "name",
           "company",
           "business",
           "country",
           "email"
          ],
          "properties": {
           "name": {
            "type": "string"
           },
           "company": {
            "type": "string"
           },
           "email": {
            "type": "string",
            "format": "email"
           },
           "phone": {
            "type": "string"
           },
           "business": {
            "type": "string",
            "enum": [
             "Hotel or resort",
             "Restaurant or café",
             "Catering or events",
             "Distributor or wholesaler",
             "Retailer or online store",
             "Other"
            ]
           },
           "country": {
            "type": "string",
            "description": "Destination: United Arab Emirates, Saudi Arabia, Oman, Qatar, Kuwait, Bahrain, Other"
           }
          }
         },
         "samples": {
          "type": "boolean"
         },
         "logo_decoration": {
          "type": "boolean"
         },
         "message": {
          "type": "string"
         },
         "agent": {
          "type": "object",
          "properties": {
           "name": {
            "type": "string"
           },
           "platform": {
            "type": "string"
           }
          }
         }
        }
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "Received",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "422": {
      "description": "Invalid",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "429": {
      "description": "Limit",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  }
 }
}