# SAN Foundation Event Lookup by ID

> SAN Foundation Event Lookup by ID is a paid API for AI agents from gateway.sanfoundation.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Resolves a single canonical SAN event by its evt_… identifier, returning the full event envelope including all metadata and source details.

## Facts

- Endpoint: GET https://gateway.sanfoundation.com/x402/v1/events/:eventId
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gateway-sanfoundation-com-f97140dc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6lrT0fv7SN372yHXh49NX

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gateway-sanfoundation-com-f97140dc
```

Example prompt: Can you pull up the full details for SAN event evt_a1b2c3d4 — I found that citation in a SAN report and need to see the complete event envelope behind it.

## When to prefer this

Use this endpoint when you have a specific evt_… event ID — typically cited in a SAN report — and need to resolve it back to the full canonical event envelope. Prefer this over listing or searching endpoints when you already know the exact event ID and want complete, structured event data for a single record.

## Known failure modes

- Invalid or malformed event ID returns 404 not found
- Missing payment header or insufficient USDC balance returns 402 Payment Required
- Event ID exists but access is restricted returns 403 Forbidden
- Malformed evt_… format may return 400 Bad Request
- Network or gateway timeout returns 5xx error

## How this service works

Look up a single canonical event by its `evt_…` id. Reports cite events by this id, so this endpoint resolves a citation back to its full envelope.

## Output

Returns the full canonical event envelope for the requested evt_… ID, including all event metadata, collapsed source articles, and any additional context that SAN Foundation attached to that event record.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gateway-sanfoundation-com-f97140dc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.sanfoundation.com](https://www.zero.xyz/host/gateway.sanfoundation.com/llms.txt)