{
  "openapi": "3.1.0",
  "info": {
    "title": "Duqqan Public API",
    "version": "1.0.0",
    "summary": "Read-only, agent-callable data about Duqqan's website package, supported business types, and example sites.",
    "description": "A small public API over data already published on duqqan.app. It exposes no customer data and does not create or modify websites — site creation is a human, register-gated flow. This REST API stays read-only; with the owner's OAuth consent, an agent edits a site's draft and publishes it through the MCP server at /api/mcp (see /auth.md). For a prose overview see /llms.txt.",
    "termsOfService": "https://duqqan.app/terms",
    "contact": {
      "name": "Duqqan",
      "email": "hello@duqqan.app",
      "url": "https://duqqan.app"
    },
    "license": {
      "name": "Proprietary",
      "url": "https://duqqan.app/terms"
    }
  },
  "servers": [
    {
      "url": "https://duqqan.app"
    }
  ],
  "externalDocs": {
    "description": "Human-readable API docs",
    "url": "https://duqqan.app/docs/api"
  },
  "paths": {
    "/api/v1/plans": {
      "get": {
        "operationId": "listPlans",
        "summary": "The one website package Duqqan sells — a yearly plan, with its price (integer minor units + currency) and what it includes — and how long the free demo (no card) and the package's free trial (card at checkout) last.",
        "responses": {
          "200": {
            "description": "The package",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Plans"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/verticals": {
      "get": {
        "operationId": "listVerticals",
        "summary": "List supported verticals and business categories.",
        "responses": {
          "200": {
            "description": "Taxonomy",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/v1/examples": {
      "get": {
        "operationId": "listExamples",
        "summary": "List showcased example sites.",
        "responses": {
          "200": {
            "description": "Examples",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/v1/openapi.json": {
      "get": {
        "operationId": "getOpenApi",
        "summary": "This OpenAPI document.",
        "responses": {
          "200": {
            "description": "OpenAPI 3.1 document",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/health": {
      "get": {
        "operationId": "health",
        "summary": "Liveness probe.",
        "responses": {
          "200": {
            "description": "ok",
            "content": {
              "text/plain": {}
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Money": {
        "type": "object",
        "required": [
          "amount",
          "currency"
        ],
        "properties": {
          "amount": {
            "type": "integer",
            "description": "Price in integer minor units (fils for AED)."
          },
          "currency": {
            "type": "string",
            "enum": [
              "AED"
            ]
          }
        }
      },
      "Plans": {
        "type": "object",
        "required": [
          "currency",
          "demo_days",
          "trial_days",
          "free_period_terms",
          "vat_note",
          "plans"
        ],
        "properties": {
          "currency": {
            "type": "string",
            "enum": [
              "AED"
            ]
          },
          "demo_days": {
            "type": "integer"
          },
          "trial_days": {
            "type": "integer"
          },
          "free_period_terms": {
            "type": "string"
          },
          "vat_note": {
            "type": "string"
          },
          "plans": {
            "type": "array",
            "minItems": 1,
            "maxItems": 1,
            "description": "The one package on sale.",
            "items": {
              "type": "object",
              "required": [
                "id",
                "name",
                "prices",
                "features"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "enum": [
                    "starter"
                  ]
                },
                "name": {
                  "type": "string"
                },
                "prices": {
                  "type": "object",
                  "required": [
                    "yearly"
                  ],
                  "additionalProperties": false,
                  "properties": {
                    "yearly": {
                      "type": "object",
                      "required": [
                        "regular"
                      ],
                      "properties": {
                        "regular": {
                          "$ref": "#/components/schemas/Money"
                        }
                      }
                    }
                  }
                },
                "features": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}