Statistics

Get aggregated statistics

Returns aggregated Pomodoro statistics for a time period. Includes chart data for visualization.

Production (Pomodoro microservice)StagingUAT

GEThttps://pomodoro.ankiren.com/api/me/pomodoro/stats

Parameters

Query Parameters

period"D" | "W" | "M" | …query
Time period for aggregation (default W)
enum: D, W, M, Y, ALL

Responses

200 · Aggregated statistics

period"D" | "W" | "M" | …Required
Time period for statistics:
- D: Today only
- W: Last 7 days
- M: Last 30 days
- Y: Last 365 days
- ALL: All time
enum: D, W, M, Y, ALL
totalWorkSessionsintegerRequired
Total work sessions in period
totalWorkMinutesintegerRequired
Total work minutes in period
totalBreakSessionsintegerRequired
Total break sessions in period
totalBreakMinutesintegerRequired
Total break minutes in period
averageWorkSessionsPerDaynumberRequired
Average work sessions per day
format: float
longestStreakintegerRequired
Longest work session streak in period
currentStreakintegerRequired
Current work session streak
chartData[object]Required
- datestring<date>
  format: date
- workSessionsinteger
- workMinutesinteger

application/json

{
  "period": "W",
  "totalWorkSessions": 28,
  "totalWorkMinutes": 700,
  "totalBreakSessions": 21,
  "totalBreakMinutes": 175,
  "averageWorkSessionsPerDay": 4,
  "longestStreak": 6,
  "currentStreak": 2,
  "chartData": [
    {
      "date": "2026-01-04",
      "workSessions": 4,
      "workMinutes": 100
    },
    {
      "date": "2026-01-05",
      "workSessions": 5,
      "workMinutes": 125
    },
    {
      "date": "2026-01-10",
      "workSessions": 3,
      "workMinutes": 75
    }
  ]
}

Sample Code

Đổi ngôn ngữ ở ô Language trên thanh Documentation.

cURL

curl -X GET 'https://pomodoro.ankiren.com/api/me/pomodoro/stats' \
  -H 'Authorization: Bearer <token>' \
  -H 'Accept: application/json'