{
  "name": "ecentic agent API",
  "version": "1",
  "description": "ecentic is one layer between a brand's catalog and the AI assistants that sell it. It optimizes the data they read, gets checkout ready for them to buy, and changes with them when their rules change. Public JSON surfaces cover discovery, onboarding, account setup and billing. Authentication requirements are declared per endpoint; failures use RFC 9457 application/problem+json.",
  "documentation": "https://ecentic.ai/docs",
  "openapi": "https://ecentic.ai/openapi.json",
  "versioning": {
    "strategy": "url-path",
    "current": "v1",
    "header": "API-Version",
    "policy": "https://ecentic.ai/docs/versioning",
    "deprecationNoticeDays": 180,
    "signals": {
      "deprecation": "Deprecation header (RFC 9745) on every response of a deprecated version.",
      "sunset": "Sunset header (RFC 8594) carrying the date the version stops answering."
    }
  },
  "rateLimit": {
    "policy": "https://ecentic.ai/docs/rate-limits",
    "headers": [
      "RateLimit-Policy",
      "RateLimit",
      "RateLimit-Limit",
      "RateLimit-Remaining",
      "RateLimit-Reset",
      "Retry-After"
    ]
  },
  "errors": {
    "mediaType": "application/problem+json",
    "specification": "https://www.rfc-editor.org/rfc/rfc9457",
    "documentation": "https://ecentic.ai/docs/errors"
  },
  "endpoints": [
    {
      "path": "/api/v1",
      "method": "GET",
      "summary": "Index of the public ecentic agent API.",
      "authentication": "none",
      "url": "https://ecentic.ai/api/v1"
    },
    {
      "path": "/api/v1/health",
      "method": "GET",
      "summary": "Liveness of the ecentic service.",
      "authentication": "none",
      "url": "https://ecentic.ai/api/v1/health"
    },
    {
      "path": "/api/v1/discovery",
      "method": "GET",
      "summary": "Every machine-readable discovery document ecentic publishes, by protocol.",
      "authentication": "none",
      "url": "https://ecentic.ai/api/v1/discovery"
    },
    {
      "path": "/api/v1/plans",
      "method": "GET",
      "summary": "Public ecentic plan catalog with prices and billing mode.",
      "authentication": "none",
      "url": "https://ecentic.ai/api/v1/plans"
    },
    {
      "path": "/api/v1/onboarding",
      "method": "GET",
      "summary": "What an agent can do before any human step, each signal with a URL that proves it.",
      "authentication": "none",
      "url": "https://ecentic.ai/api/v1/onboarding"
    },
    {
      "path": "/api/v1/sandbox",
      "method": "GET",
      "summary": "Zero-auth sandbox: what it offers, its limits, and its caveats.",
      "authentication": "none",
      "url": "https://ecentic.ai/api/v1/sandbox"
    },
    {
      "path": "/api/v1/sandbox/simulation",
      "method": "POST",
      "summary": "Run a synthetic product-vs-competitor simulation with no account.",
      "authentication": "none",
      "url": "https://ecentic.ai/api/v1/sandbox/simulation"
    },
    {
      "path": "/api/v1/skills",
      "method": "GET",
      "summary": "Agent skills ecentic publishes, with their SKILL.md locations.",
      "authentication": "none",
      "url": "https://ecentic.ai/api/v1/skills"
    },
    {
      "path": "/api/v1/news",
      "method": "GET",
      "summary": "AI-commerce news wire: Google News search results parsed into JSON records.",
      "authentication": "none",
      "url": "https://ecentic.ai/api/v1/news"
    },
    {
      "path": "/api/mcp",
      "method": "POST",
      "summary": "MCP JSON-RPC endpoint (tools/list, tools/call).",
      "authentication": "bearer",
      "url": "https://ecentic.ai/api/mcp"
    },
    {
      "path": "/api",
      "method": "GET",
      "summary": "x402-payable agent API root.",
      "authentication": "x402",
      "url": "https://ecentic.ai/api"
    }
  ]
}