How do I read activity through the API?
GET /events lists what investors did, newest first. Filter with type (several, separated by commas), investor_id, document_id, since and until. Each event looks like this:
{
"id": "…",
"type": "document.viewed",
"occurred_at": "2026-10-17T09:30:00.000Z",
"investor": { "id": "…", "email": "ananya@northwind.example", "name": "Ananya Rao" },
"document": { "id": "…", "name": "Pitch deck" },
"details": {}
}| Type | When | Details |
|---|---|---|
document.viewed | An investor opens a document. | |
document.downloaded | An investor downloads one. | folder_id, when it was part of a folder's download |
investor.signed_in | An investor signs in. | |
investor.joined | An investor accepts their invitation. | |
nda.accepted | An investor accepts the NDA. | nda_version |
question.asked | An investor asks a question. | question_id |
document.requested | An investor asks for a document. | request_id, title |
access.requested | Someone asks for access (from a deck link or the request page). investor is null. | request_id, email, name, source, repeated |
investor.invited | Someone is invited. | invitation_id |
investor.revoked | An investor is revoked. | invitation_id, when known |
Events never include IP addresses, places or devices, and your own team's activity isn't listed. For reading time and pages per document, use GET /investors/{id}.