Reports
Aggregated time totals and breakdowns over a date window.
Time report summary
GET /api/v1/reports/summary — scope reports:read
Aggregates tracked time for the organization over a window, with daily totals and top clients/projects.
| Query param | Description |
|---|---|
start, end | ISO 8601 window. Defaults to the last 30 days. Max 2 years. |
client_id, project_id | Scope the aggregation. |
limit | Rows in each breakdown, 1–100. Defaults to 10. |
curl "https://app.militime.ai/api/v1/reports/summary?start=2026-06-01T00:00:00Z&end=2026-07-01T00:00:00Z" \
-H "Authorization: Bearer mt_live_your_token"{
"object": "report_summary",
"range": {
"start": "2026-06-01T00:00:00.000Z",
"end": "2026-07-01T00:00:00.000Z"
},
"totals": {
"total_seconds": 486000,
"billable_seconds": 432000,
"non_billable_seconds": 54000,
"entry_count": 240
},
"daily": [
{ "day": "2026-06-01", "total_seconds": 18000, "billable_seconds": 16200, "entry_count": 9 }
],
"top_clients": [
{ "client_id": "cl_123", "total_seconds": 180000, "billable_seconds": 172800, "entry_count": 96 }
],
"top_projects": [
{ "project_id": "pr_123", "client_id": "cl_123", "total_seconds": 120000, "billable_seconds": 118800, "entry_count": 64 }
]
}All durations are in seconds. Resolve client_id / project_id against the
clients and projects endpoints for names.