> ## Documentation Index > Fetch the complete documentation index at: https://docs.sanfoundation.com/llms.txt > Use this file to discover all available pages before exploring further. # Get event > Full canonical event envelope for a specific `evt_…` id, used to resolve a citation in an agent report back to the underlying event. ## OpenAPI ````yaml https://playground.sanfoundation.com/openapi.yaml get /api/v1/events/{eventId} openapi: 3.1.0 info: title: SAN Foundation Gateway API version: 1.0.0 description: | Public API for the SAN Foundation gateway. The same data is exposed through two interchangeable surfaces: `/api/v1/*` is authenticated with an `x-api-key` (`sk_…`) and billed in credits (per-call cost in `x-credits`); `/x402/v1/*` is paid per call in USDC over the [x402 protocol](https://x402.org) and requires no API key (per-call cost in `x-price-usd`). servers: - url: https://gateway.sanfoundation.com description: Production security: [] tags: - name: API Key description: | Operations under `/api/v1/*`. Authenticate with a SAN API key (`x-api-key` header) and pay with prepaid credits — see each operation's `x-credits` for the per-call cost. - name: x402 description: | Operations under `/x402/v1/*`. Pay per call in USDC over the [x402 protocol](https://x402.org) — see each operation's `x-price-usd` for the per-call cost. No API key required. - name: Registration description: | Public, unauthenticated self-onboarding for agents. One call mints an API key and grants the signup credit so an agent can immediately use `/api/v1/*`. Rate limited per client IP. paths: /api/v1/events/{eventId}: get: tags: - API Key summary: Get event description: >- Full canonical event envelope for a specific `evt_…` id, used to resolve a citation in an agent report back to the underlying event. operationId: getEvent parameters: - $ref: '#/components/parameters/EventIdPath' responses: '200': $ref: '#/components/responses/EventEnvelope' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/EventNotFound' security: - ApiKeyAuth: [] components: parameters: EventIdPath: in: path name: eventId required: true description: Stable canonical event id (e.g. `evt_d62a81a5e8b2366027fbaf6b`). schema: type: string pattern: ^evt_[a-z0-9]{16,}$ examples: sample: value: evt_d62a81a5e8b2366027fbaf6b responses: EventEnvelope: description: OK — single canonical event envelope. content: application/json: schema: $ref: '#/components/schemas/EventResponse' Unauthorized: description: >- Missing, invalid, or revoked API key (emitted by key-authenticated `/api/*` endpoints). content: application/json: schema: $ref: '#/components/schemas/Error' examples: missing: value: error: Missing or invalid x-api-key header invalid: value: error: Invalid API key Forbidden: description: | The API key is valid but its owning account has no active Stripe subscription (status is not `active` or `trialing`). Only emitted by `/api/v1/*`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: >- Active subscription required. Please set up billing at your dashboard. EventNotFound: description: No event matched the supplied id. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: event not found eventId: evt_unknown schemas: EventResponse: type: object required: - event properties: event: $ref: '#/components/schemas/PublicEvent' Error: type: object required: - error properties: error: type: string ref: type: string description: Echoed back when an agent ref could not be resolved. eventId: type: string description: Echoed back when an event id could not be resolved. min: type: integer description: Echoed back on a `limit out of range` error. max: type: integer description: Echoed back on a `limit out of range` error. PublicEvent: type: object required: - eventId - title - summary - firstSeenAt - lastUpdatedAt - primaryAgent - eventType - status - confidence - tags - sourceCount - entities - locations - sources properties: eventId: type: string description: Stable canonical event identifier. title: type: string description: Canonical (deduplicated) headline. summary: type: string occurredAt: type: - string - 'null' format: date-time description: When the underlying event occurred, if known. firstSeenAt: type: string format: date-time lastUpdatedAt: type: string format: date-time primaryAgent: type: string description: Display name of the primary agent. eventType: type: string description: e.g. `statement`, `release`, `incident`. status: type: string description: e.g. `active`, `archived`. confidence: type: string enum: - low - medium - high tags: type: array items: type: string sourceCount: type: integer description: Number of distinct source articles clustered into this event. entities: type: array items: $ref: '#/components/schemas/EventEntity' locations: type: array items: $ref: '#/components/schemas/EventLocation' sources: type: array items: $ref: '#/components/schemas/EventSource' EventEntity: type: object required: - name - type - role properties: name: type: string type: type: string description: e.g. `person`, `organization`, `concept`. role: type: string description: e.g. `primary`, `mentioned`. EventLocation: type: object required: - name properties: name: type: string country: type: - string - 'null' EventSource: type: object required: - url properties: url: type: string format: uri publication: type: - string - 'null' publishedAt: type: - string - 'null' format: date-time securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: | SAN-issued API key (`sk_…`) issued from the SAN Agents Dashboard (Settings → API Keys). Used by every `/api/v1/*` endpoint; usage is billed in credits against the owning account's active Stripe subscription. ````