API

List the download links of a file

How often each copy sent as a link was fetched.

GETapi.openemail.uk/files/{id}/links

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

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.