Skip to the documentation
API

File stats

The numbers on the Analytics tab of the Files page.

GET/files/stats

Runs the real call on your workspace.

GET /files/stats

The numbers on the Analytics tab of the Files page.

Example

Needs files:read. types holds the eight file types taking the most space, addresses the six addresses holding the most, and byDay the last 30 days in UTC, leaving out the days nothing was added.

curl
curl "$OE/files/stats" -H "$AUTH"
Response
{  "object": "file_stats",  "totals": { "files": 412, "bytes": 918273645 },  "received": { "files": 301, "bytes": 612004311 },  "sent": { "files": 96, "bytes": 281102734 },  "uploaded": { "files": 15, "bytes": 25166600 },  "types": [    { "mimeType": "application/pdf", "files": 188, "bytes": 402113870 },    { "mimeType": "image/jpeg", "files": 121, "bytes": 233901112 }  ],  "byDay": [    { "day": "2026-09-23", "files": 7, "bytes": 5120331 },    { "day": "2026-09-24", "files": 3, "bytes": 1048576 }  ],  "addresses": [    { "address": "[email protected]", "files": 140, "bytes": 377120994 }  ],  "links": { "shares": 12, "downloads": 57, "lastDownloadAt": "2026-09-24T08:02:19.000Z" }}

links counts the download links that still work and how often they were fetched. A key limited to particular addresses or domains counts only the files on them.

Reference