# Clous Docs — full agent index > Agent-native SEC data infrastructure. Clous is a SEC / EDGAR filings API built for AI > agents. It resolves filings to canonical entities and serves them through one > consistent JSON envelope — with confidence and freshness on every enriched field — > over REST and (soon) a hosted MCP server. All data is derived from public SEC EDGAR > filings. Clous is an independent service and is not affiliated with, endorsed by, or > sponsored by the U.S. Securities and Exchange Commission. This is the expanded, agent-readable index of the Clous documentation at https://docs.clous.ai. It is kept honest to what is live in production. ==================================================================== WHAT IS LIVE vs COMING SOON ==================================================================== LIVE in production today: - Form ADV investment-adviser endpoints: - GET /v1/advisers list / search registered investment advisers - GET /v1/advisers/{crd} full adviser profile by CRD number - The shared response envelope, entity resolution, cursor pagination, error codes. COMING SOON (on the roadmap, NOT live — do not rely on these yet): - More SEC forms: 13F, Form D, Form 4, N-PORT, N-CEN. - Platform features: hosted MCP server at mcp.clous.ai, webhooks + logs, watchlists, company-list upload, AI filing briefings. ==================================================================== BASE URL & AUTH ==================================================================== - API base URL: https://api.clous.ai - OpenAPI 3.1 spec: https://api.clous.ai/openapi.json - Content type: application/json - Auth: every request requires an API key as a Bearer token: Authorization: Bearer clous_live_... - Keys are created in the dashboard at https://app.clous.ai. - Free Sandbox grants 100 one-time credits for evaluation; it calls the same live endpoints as paid plans (no separate sandbox host). ==================================================================== RESPONSE ENVELOPE ==================================================================== Every endpoint returns the same top-level object: { "data": [ ...records... ], "page": { "limit": 25, "next_cursor": "", "has_more": true|false }, "as_of": "", "source": "", "query_echo": { ...the normalized typed params Clous actually applied... }, "warnings": [ ...non-fatal notes, e.g. empty_result... ] } - Records carry provenance: source and source_url back to the underlying filing. - Enriched (non-source) fields are returned as structured values with confidence and freshness rather than bare facts. ==================================================================== ENDPOINT: GET /v1/advisers (list / search Form ADV advisers) ==================================================================== Query parameters (all optional unless noted): - aum_min integer >= 0 Minimum total regulatory AUM in USD. - aum_max integer >= 0 Maximum total regulatory AUM in USD. - state string Adviser main-office state, e.g. "NY". - has_private_funds boolean Only advisers that report private funds. - disciplinary boolean Filter on Item 11 disciplinary history. - q string Substring match over legal / business name. - cursor string Pagination cursor from a prior page.next_cursor. - limit integer 1..100 Page size, default 25. Status codes: - 200 Success. An empty match returns 200 with data: [] and a warnings entry. - 422 Validation error (a param was the wrong type or out of range). Example: curl -s "https://api.clous.ai/v1/advisers?state=NY&aum_min=1000000000&limit=5" \ -H "Authorization: Bearer clous_live_..." Example response (illustrative values): { "data": [ { "crd": "105958", "business_name": "THE VANGUARD GROUP, INC.", "regulatory_aum_total": 8500000000000, "has_private_funds": false, "address": { "city": "Malvern", "state": "PA", "country": "United States" }, "source": "SEC EDGAR — Form ADV", "source_url": "https://reports.adviserinfo.sec.gov/reports/ADV/105958/PDF/105958.pdf" } ], "page": { "limit": 5, "next_cursor": "eyJvIjo1fQ", "has_more": true }, "as_of": "2026-06-11T00:00:00Z", "source": "SEC EDGAR — Form ADV", "query_echo": { "state": "NY", "aum_min": 1000000000, "limit": 5 }, "warnings": [] } ==================================================================== ENDPOINT: GET /v1/advisers/{crd} (adviser full profile by CRD) ==================================================================== Path parameter: - crd string (required) The adviser's CRD number, e.g. "105958". Status codes: - 200 Success. The profile is the single record in data. - 422 Validation error on the crd path parameter. - A CRD that resolves to no adviser uses the not_found error semantics. Example: curl -s "https://api.clous.ai/v1/advisers/105958" \ -H "Authorization: Bearer clous_live_..." ==================================================================== PAGINATION (cursor-based) ==================================================================== - No offset parameter, no 10,000-result ceiling. - Read page.next_cursor and pass it back verbatim as the cursor query param. - Stop when page.has_more is false. - Cursors are opaque; do not parse or construct them. ==================================================================== ERROR CODES ==================================================================== - empty_result Valid query, no matches. Returns 200 with data: [] + warnings. - entity_unresolved An identifier could not be resolved to a canonical entity. - not_found A specific resource (e.g. a CRD) does not exist. - invalid_param Wrong type / malformed / out of range. Returned as HTTP 422. - rate_limited Throttled, or the account's credit balance is exhausted. 422 body shape (OpenAPI): { "detail": [ { "loc": ["query","aum_min"], "msg": "...", "type": "..." } ] } ==================================================================== RATE LIMITS & COST CONTROL ==================================================================== - Requests may be throttled (rate_limited); back off with exponential retry. - Usage is metered in credits; when credits are exhausted, calls stop rather than silently incurring charges. Manage plans and usage at https://app.clous.ai. ==================================================================== PRICING (credits, metered) ==================================================================== Plans (price / included credits / overage per 1,000): - Free Sandbox $0 / 100 / no overage (evaluation only) - Starter $49/mo / 7,500 / $10.00 - Builder $149/mo / 35,000 / $7.50 - Pro $399/mo / 125,000 / $5.00 - Scale $999/mo / 500,000 / $3.50 - Business $2,500/mo / 1,500,000 / $2.50 - Enterprise custom / custom / custom Credit cost per operation (ranges depend on result size/depth): - Resolve identifier -> entity 1-2 - Search filings 3-5 - Filing metadata 3-5 - Download / parse a filing 10-20 - AI filing briefing 25-50 - Full company profile 25-50 - Watchlist event 5-20 (Several of these correspond to roadmap endpoints; live Form ADV calls fall under filing search / metadata.) ==================================================================== MCP (COMING SOON) ==================================================================== - Planned hosted MCP server: https://mcp.clous.ai - Same Bearer auth and same response envelope as REST. - Not live yet — use the REST endpoints above today. ==================================================================== DOCS PAGES ==================================================================== - Introduction: https://docs.clous.ai/docs - Quickstart: https://docs.clous.ai/docs/quickstart - Authentication: https://docs.clous.ai/docs/authentication - Credits & Pricing: https://docs.clous.ai/docs/pricing - API Reference index: https://docs.clous.ai/docs/api - Advisers reference: https://docs.clous.ai/docs/api/advisers - Pagination/Errors: https://docs.clous.ai/docs/pagination-errors-rate-limits - MCP (coming soon): https://docs.clous.ai/docs/mcp - Roadmap: https://docs.clous.ai/docs/roadmap - Concise index: https://docs.clous.ai/llms.txt