---
title: "File stats"
description: "The numbers on the Analytics tab of the Files page."
url: "https://openemail.uk/docs/api/files/stats"
area: "API"
category: "Mailbox"
---

# File stats

The numbers on the Analytics tab of the Files page.

`GET /files/stats`

## 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": "billing@acme.com", "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.