Statistics

Voice activity

GET/v1/guilds/:guildId/stats/voice

NeedsOwner's keynyx+stats:read

Voice joins and minutes spent in voice for each day, the total minutes, and the voice channels that were used, most minutes first.

Days are UTC calendar days, and from and to are both inclusive. The response echoes the range nyx actually applied, which can be narrower than the one asked for when it reaches past the history nyx keeps.

joins counts connections, not people: a member who joins voice twice in a day counts twice. channels lists only channels with voice time in the range; name is null once a channel has been deleted.

Query parameters

fromdate: First day, inclusive, in UTC. Defaults to 29 days before to, so the default range is 30 days.
todate: Last day, inclusive, in UTC. Defaults to today. The range may span at most 365 days.

Errors

400 BAD_REQUEST when:

from or to is not a real date in YYYY-MM-DD form.
from is after to.
The range spans more than 365 days, counting both ends.

Plus the failures every endpoint shares, listed under errors & limits.

Request

$ curl "https://api.nyx.cool/v1/guilds/1467281625954914369/stats/voice?from=2026-09-28&to=2026-10-04" \
    -H "Authorization: Bearer nyx_live_..."

Response200

{
  "guildId": "1467281625954914369",
  "from": "2026-09-28",
  "to": "2026-10-04",
  "totalMinutes": 2432,
  "joins": [
    { "day": "2026-09-28", "count": 18 },
    { "day": "2026-09-29", "count": 12 },
    { "day": "2026-09-30", "count": 15 },
    { "day": "2026-10-01", "count": 11 },
    { "day": "2026-10-02", "count": 14 },
    { "day": "2026-10-03", "count": 24 },
    { "day": "2026-10-04", "count": 29 }
  ],
  "minutes": [
    { "day": "2026-09-28", "count": 310 },
    { "day": "2026-09-29", "count": 285 },
    { "day": "2026-09-30", "count": 402 },
    { "day": "2026-10-01", "count": 268 },
    { "day": "2026-10-02", "count": 330 },
    { "day": "2026-10-03", "count": 461 },
    { "day": "2026-10-04", "count": 376 }
  ],
  "channels": [
    {
      "channelId": "1467281626626003066",
      "name": "Lounge",
      "minutes": 1490
    },
    {
      "channelId": "1467281626626003071",
      "name": "Gaming",
      "minutes": 712
    },
    {
      "channelId": "1467281626626003074",
      "name": "Study hall",
      "minutes": 230
    }
  ]
}

Response400

{
  "code": "BAD_REQUEST",
  "message": "The range 2025-01-01 to 2026-10-04 spans 642 days; the maximum is 365"
}