---
title: "List the download links of a file"
description: "How often each copy sent as a link was fetched."
url: "https://openemail.uk/docs/api/files/links"
area: "API"
category: "Mailbox"
---

# List the download links of a file

How often each copy sent as a link was fetched.

`GET /files/{id}/links`

## GET /files/{id}/links

How often each copy sent as a link was fetched.

## Example

Needs `threads:read`. A large attachment sent from OpenEmail travels as a link rather than inside the message, and every send makes a link of its own. They come newest first, revoked ones included.

**curl**

```
curl "$OE/files/file_6bb640f5b99e47deb758f1f5/links" -H "$AUTH"
```

**Response**

```
{
  "object": "list",
  "data": [
    {
      "object": "file_link",
      "id": "fshr_9f2c1a4b7e05d3862c1f0a44",
      "fileId": "file_6bb640f5b99e47deb758f1f5",
      "filename": "invoice-0912.pdf",
      "mimeType": "application/pdf",
      "sizeBytes": 184233,
      "host": "files.acme.com",
      "url": "https://files.acme.com/f/3b1f…/invoice-0912.pdf",
      "downloads": 3,
      "lastDownloadAt": "2026-09-14T16:20:11.000Z",
      "revokedAt": null,
      "createdAt": "2026-09-12T08:41:03.000Z"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}
```

> A file attached inside a message has no links, because nothing records when those are opened. The count leaves out scanners and link previewers.