{
  "openapi": "3.0.0",
  "info": {
    "title": "Boru Consulting API",
    "description": "Access to Boru Consulting's insights, services, and contact information",
    "version": "1.0.0",
    "contact": {
      "name": "Boru Consulting Group",
      "url": "https://www.boruconsulting.com",
      "email": "info@boruconsulting.com"
    }
  },
  "servers": [
    {
      "url": "https://www.boruconsulting.com",
      "description": "Production server"
    }
  ],
  "paths": {
    "/blog": {
      "get": {
        "operationId": "getBlogArticles",
        "summary": "Get all blog articles",
        "description": "Returns a list of all published insights and analysis articles",
        "responses": {
          "200": {
            "description": "List of blog articles",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/blog/{slug}": {
      "get": {
        "operationId": "getBlogArticle",
        "summary": "Get a specific blog article",
        "description": "Returns a single blog article by its slug",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "selling-uk-property-after-moving-to-dubai",
                "uae-family-office-difc-adgm-corporate-tax",
                "selling-business-crypto-after-moving-to-dubai",
                "difc-adgm-foundations-wealth-holding",
                "offshore-trust-settlor-transparent-restructuring",
                "uae-corporate-tax-transfer-pricing-disclosure-2026",
                "uae-property-spv-corporate-tax-9-percent",
                "uk-temporary-non-residence-cgt-clawback",
                "uae-golden-visa-tax-residency",
                "uk-non-dom-abolition-uae-iht-tail",
                "moving-to-dubai-from-uk-tax-residence",
                "dubai-company-from-uk-tax-residence",
                "uae-corporate-tax-2026-free-zone",
                "uk-holdco-post-brexit-sse",
                "uae-fdl-17-2025-fta-audit-procedures",
                "transfer-pricing-dempe-uk-uae-corridor",
                "wholesale-cbdc-family-office-uk-uae",
                "uae-cabinet-decision-209-eoi-accounting",
                "uk-pillar-two-2025-amendments-first-filing",
                "eccta-failure-to-prevent-fraud-procedures",
                "uk-carf-crypto-reporting-family-office-2026",
                "uk-pension-iht-2027-corridor",
                "uk-sao-evidence-pack-2026",
                "uae-dmtt-first-filing-cycle-2026",
                "ireland-holdco-uk-uae-corridor",
                "the-uae-einvoicing-30-october-2026-asp-deadline-what-phase-1-entities-must-do",
                "pillar-two-uae-dmtt-the-15-floor-under-every-other-uae-tax-outcome",
                "pre-exit-year-checklist-uk-to-uae-hnwi",
                "difc-adgm-wills-cross-border-estate",
                "uae-golden-visa-post-fig-uk-resident",
                "uae-qfzp-qualifying-income",
                "fic-vs-trust-uk-hnwi",
                "uae-individual-tax-residence-90-day-rule",
                "uk-statutory-residence-test-hnwi",
                "cgt-rebasing-2017-election-former-nondom",
                "protected-settlements-post-april-2025",
                "long-term-resident-iht-tail-planning",
                "non-dom-exit-trf-temporary-repatriation",
                "post-non-dom-uae-cfc",
                "uae-corporate-tax-regime-strategic-implications",
                "uk-holding-company-post-brexit-analysis",
                "operational-resilience-risk-governance"
              ]
            },
            "description": "The article slug"
          }
        ],
        "responses": {
          "200": {
            "description": "Blog article content",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Article not found"
          }
        }
      }
    },
    "/ai-metadata.json": {
      "get": {
        "operationId": "getMetadata",
        "summary": "Get structured metadata",
        "description": "Returns comprehensive metadata about Boru Consulting in JSON-LD format",
        "responses": {
          "200": {
            "description": "Structured metadata",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/rss.xml": {
      "get": {
        "operationId": "getRSSFeed",
        "summary": "Get RSS feed",
        "description": "Returns RSS feed of all blog articles",
        "responses": {
          "200": {
            "description": "RSS feed",
            "content": {
              "application/rss+xml": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "operationId": "getLlmsTxt",
        "summary": "Get the llms.txt knowledge directory",
        "description": "Returns the llms.txt directory of core resources and semantic content clusters",
        "responses": {
          "200": {
            "description": "llms.txt document",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "operationId": "getLlmsFullTxt",
        "summary": "Get the full LLM knowledge base",
        "description": "Returns the complete concatenated knowledge base for full-context LLM ingestion",
        "responses": {
          "200": {
            "description": "llms-full.txt document",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Article": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "description": "Article title"
          },
          "slug": {
            "type": "string",
            "description": "URL-friendly identifier"
          },
          "excerpt": {
            "type": "string",
            "description": "Brief summary"
          },
          "category": {
            "type": "string",
            "description": "Article category"
          },
          "date": {
            "type": "string",
            "description": "Publication date"
          },
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Article keywords"
          }
        }
      }
    }
  }
}