Get Events Overview

GET

/dory/analytics

GET

/api/v1/dory/analytics

curl -G https://api.taktoria.com/api/v1/dory/analytics \
     -H "Authorization: Bearer <token>" \
     -d days=7

{
  "days": 7,
  "events": 2,
  "participants": 324,
  "questions": 31,
  "answeredShare": 74,
  "upvotes": 455,
  "pollResponses": 180,
  "joinsPerDay": [
    {
      "at": "2026-09-27T00:00:00Z",
      "count": 0
    },
    {
      "at": "2026-09-28T00:00:00Z",
      "count": 14
    },
    {
      "at": "2026-09-29T00:00:00Z",
      "count": 0
    },
    {
      "at": "2026-09-30T00:00:00Z",
      "count": 0
    },
    {
      "at": "2026-10-01T00:00:00Z",
      "count": 310
    },
    {
      "at": "2026-10-02T00:00:00Z",
      "count": 0
    },
    {
      "at": "2026-10-03T00:00:00Z",
      "count": 0
    }
  ],
  "questionsPerDay": [
    {
      "at": "2026-09-27T00:00:00Z",
      "count": 0
    },
    {
      "at": "2026-09-28T00:00:00Z",
      "count": 7
    },
    {
      "at": "2026-09-29T00:00:00Z",
      "count": 0
    },
    {
      "at": "2026-09-30T00:00:00Z",
      "count": 0
    },
    {
      "at": "2026-10-01T00:00:00Z",
      "count": 24
    },
    {
      "at": "2026-10-02T00:00:00Z",
      "count": 0
    },
    {
      "at": "2026-10-03T00:00:00Z",
      "count": 0
    }
  ],
  "top": [
    {
      "id": "evt_7f3a",
      "title": "Q3 all-hands",
      "phase": "ended",
      "archived": false,
      "participants": 310,
      "questions": 24,
      "answeredShare": 75
    },
    {
      "id": "evt_2b91",
      "title": "Team retro",
      "phase": "ended",
      "archived": false,
      "participants": 14,
      "questions": 7,
      "answeredShare": 71
    }
  ]
}

Dory’s Analytics page: totals, people joining and questions asked per day, and the busiest events, across every event the caller may run (a key, every event in the workspace). Needs participants:read.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

daysintegerOptional

How many days back, today included; 30 unless given, at most 365.

Response

This endpoint returns an object.

daysinteger

eventsinteger

Events somebody joined in the window.

participantsinteger

questionsinteger

answeredShareinteger

The share of the window’s questions answered, in %.

upvotesinteger

pollResponsesinteger

joinsPerDaylist of objects

People joining, one bucket per UTC day, today last.

questionsPerDaylist of objects

Questions asked, one bucket per UTC day, today last.

toplist of objects

Up to ten, most people first.

Errors

401

Unauthorized Error

402

Subscription Required Error

429

Too Many Requests Error