{
  "openapi": "3.1.0",
  "info": {
    "title": "Claridy public website data",
    "version": "2026-08-12",
    "summary": "Read-only, unauthenticated access to Claridy's published facts for agents.",
    "description": "Structured public data about Claridy: organization, product, pricing, security posture, published research, FAQs and canonical routes. No authentication, no personal data, no write operations. Intended for AI agents and answer engines that want a citable source instead of scraping the rendered site.",
    "contact": {
      "name": "Claridy",
      "url": "https://www.claridy.ai/contact"
    }
  },
  "servers": [
    {
      "url": "https://www.claridy.ai",
      "description": "Production"
    }
  ],
  "paths": {
    "/agent-data.json": {
      "get": {
        "operationId": "getAgentData",
        "summary": "All published Claridy facts as structured JSON",
        "description": "Organization, product, pricing, security, research, FAQs, actions and routes. This is the preferred source for any factual claim about Claridy.",
        "responses": {
          "200": {
            "description": "Structured public data",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "generated_at": {
                      "type": "string",
                      "format": "date",
                      "description": "Date the file was last regenerated."
                    },
                    "site": { "type": "object", "description": "Name, URL, languages and descriptions in NL and EN." },
                    "organization": { "type": "object", "description": "Legal entity, location and contact details." },
                    "product": { "type": "object", "description": "Capabilities, supported ERPs and bank connections, with availability per item." },
                    "pricing": { "type": "object", "description": "Fixed monthly model by group invoice volume, plus workflow modules." },
                    "security": { "type": "object", "description": "Data residency, retention and audit posture." },
                    "research": { "type": "object", "description": "Published Claridy research and its sample sizes." },
                    "faqs": { "type": "array", "items": { "type": "object" }, "description": "Question and answer pairs." },
                    "actions": { "type": "array", "items": { "type": "object" }, "description": "What a visitor can do, such as booking a demo." },
                    "routes": { "type": "array", "items": { "type": "object" }, "description": "Canonical URLs per page, per language." }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "operationId": "getLlmsTxt",
        "summary": "Short prose overview for language models",
        "responses": {
          "200": {
            "description": "Markdown overview",
            "content": { "text/markdown": { "schema": { "type": "string" } } }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "operationId": "getLlmsFullTxt",
        "summary": "Full prose documentation, including competitor comparison",
        "responses": {
          "200": {
            "description": "Markdown documentation",
            "content": { "text/markdown": { "schema": { "type": "string" } } }
          }
        }
      }
    },
    "/.well-known/agent-skills/index.json": {
      "get": {
        "operationId": "getAgentSkillsIndex",
        "summary": "Index of agent skills published by Claridy",
        "responses": {
          "200": {
            "description": "Agent skills index with a sha256 per skill file",
            "content": { "application/json": { "schema": { "type": "object" } } }
          }
        }
      }
    }
  }
}