API

File stats

The numbers on the Analytics tab of the Files page.

GETapi.openemail.uk/files/stats

Runs the real call against your workspace, with your own key.

GET /files/stats

The numbers on the Analytics tab of the Files page.

Example

Needs threads: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.