# SAN

> Documentation for SAN

## Docs

- [API Quickstart](https://docs.sanfoundation.com/api-quickstart.md): Get an API key and start querying SAN agents over HTTP.
- [Get event](https://docs.sanfoundation.com/api-reference/api-key/get-event.md): Full canonical event envelope for a specific `evt_…` id, used to resolve a citation in an agent report back to the underlying event.
- [List agents](https://docs.sanfoundation.com/api-reference/api-key/list-agents.md): Catalog of SAN agents (the `id`, `name`, `slug`, or `externalId` you pass as `{ref}` on the agent-scoped endpoints), optionally filtered by a case-insensitive `search` substring against `name`, `domain`, and `description`.
- [List events](https://docs.sanfoundation.com/api-reference/api-key/list-events.md): Most recently updated canonical events where the agent is primary or secondary, with each event collapsing matching source articles into a single record carrying `sourceCount` and a `sources[]` array.
- [List reports](https://docs.sanfoundation.com/api-reference/api-key/list-reports.md): Generated reports for the agent in reverse-chronological order, each containing four audience-lensed sections (`personal`, `research`, `business_operations`, `trading_investments`) under both `situation` and `decisionAdvantage`.
- [Web extract](https://docs.sanfoundation.com/api-reference/api-key/web-extract.md): Fetches a single URL and returns its `title`, `publish_date` (when known), the most relevant `excerpts[]` (optionally biased by a natural-language `objective`), and the page's `full_content` as a bare object.
- [Web search](https://docs.sanfoundation.com/api-reference/api-key/web-search.md): Searches the open web for a topic and returns up to 10 ranked results with source `url`, page `title`, `publish_date` (when known), and the most relevant excerpts.
- [Get event](https://docs.sanfoundation.com/api-reference/x402/get-event.md): Same shape as `GET /api/v1/events/{eventId}`, paid per call via x402.
- [List agents](https://docs.sanfoundation.com/api-reference/x402/list-agents.md): Same shape as `GET /api/v1/agents`, paid per call via x402.
- [List events](https://docs.sanfoundation.com/api-reference/x402/list-events.md): Same shape as `GET /api/v1/agents/{ref}/events`, paid per call via x402.
- [List reports](https://docs.sanfoundation.com/api-reference/x402/list-reports.md): Same shape as `GET /api/v1/agents/{ref}/reports`, paid per call via x402.
- [Web extract](https://docs.sanfoundation.com/api-reference/x402/web-extract.md): Same shape as `POST /api/v1/web-extract`, paid per call via x402.
- [Web search](https://docs.sanfoundation.com/api-reference/x402/web-search.md): Same shape as `POST /api/v1/web-search`, paid per call via x402.
- [Introduction](https://docs.sanfoundation.com/index.md): Situational awareness for autonomous machines. SAN agents deliver continuously updated world-state intelligence so your systems don't have to build it from scratch.
- [MCP Quickstart](https://docs.sanfoundation.com/mcp-quickstart.md): Connect SAN to any MCP-compatible client.
- [OpenClaw](https://docs.sanfoundation.com/platform/openclaw.md): Use SAN inside your OpenClaw personal AI assistant.
- [x402 Quickstart](https://docs.sanfoundation.com/x402-quickstart.md): Pay per request in USDC on Base. No accounts or API keys required.

## OpenAPI Specs

- [openapi](https://docs.sanfoundation.com/api-reference/openapi.yaml)
- [openapi-legacy](https://docs.sanfoundation.com/api-reference/openapi-legacy.json)

## Optional

- [Home](https://sanfoundation.com/)
- [Gateway](https://gateway.sanfoundation.com)