Skip to main content
GET
/
api
/
v1
/
events
/
{eventId}
Get event
curl --request GET \
  --url https://gateway.sanfoundation.com/api/v1/events/{eventId} \
  --header 'x-api-key: <api-key>'
{
  "event": {
    "eventId": "<string>",
    "title": "<string>",
    "summary": "<string>",
    "firstSeenAt": "2023-11-07T05:31:56Z",
    "lastUpdatedAt": "2023-11-07T05:31:56Z",
    "primaryAgent": "<string>",
    "eventType": "<string>",
    "status": "<string>",
    "confidence": "low",
    "tags": [
      "<string>"
    ],
    "sourceCount": 123,
    "entities": [
      {
        "name": "<string>",
        "type": "<string>",
        "role": "<string>"
      }
    ],
    "locations": [
      {
        "name": "<string>",
        "country": "<string>"
      }
    ],
    "sources": [
      {
        "url": "<string>",
        "publication": "<string>",
        "publishedAt": "2023-11-07T05:31:56Z"
      }
    ],
    "occurredAt": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
x-api-key
string
header
required

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.

Path Parameters

​
eventId
string
required

Stable canonical event id (e.g. evt_d62a81a5e8b2366027fbaf6b).

Pattern: ^evt_[a-z0-9]{16,}$

Response

OK — single canonical event envelope.

​
event
object
required