v1

latestOpenAPI 3.1.02026-07-2418848.0 KB

Get team usage metrics

Retrieves aggregated team usage metrics and individual member activity for a specified date range

get/api/reports/usage

Query parameters

rangeDaysinteger

Number of days to include in the report

endDatestring date

Example:2025-07-31

End date for the report range (YYYY-MM-DD format)

Response

Successfully retrieved usage metrics

Example response

{
  "range": {
    "start": "2025-07-01",
    "end": "2025-07-31"
  },
  "aggregate": {
    "teamName": "Enterprise architecture",
    "totalMembers": 60,
    "activeMembers": 50,
    "inactiveMembers": 10,
    "totalFiles": 100,
    "totalFilesCreated": 34,
    "totalFilesViewed": 43,
    "totalFileViews": 1234,
    "totalAiCreditsUsed": 789
  },
  "members": [
    {
      "email": "alice@example.com",
      "displayName": "Alice Walker",
      "filesCreated": 5,
      "filesViewed": 7,
      "fileViews": 12,
      "aiCreditsUsed": 100,
      "lastActive": "2025-07-30T15:45:00Z"
    }
  ]
}