Get a non-counting download URL
Get a short-lived download URL that never counts toward download stats.
Return a short-lived URL that streams the file straight from storage WITHOUT incrementing its download_count. Use it for your own downloads — backups, previews, console-side fetches — so owner activity never inflates the recipient-facing counter. The public /f/ link in your emails stays the counting path.
GET /v3/uploads/{id}/download
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Required | The upload id returned by POST /v3/uploads — always starts with up_ (e.g. up_9f3KzQ7wXt2mB4hN). |
Responses
| Status | Description |
|---|---|
200 | An object with a single url — short-lived, so fetch it right before downloading rather than storing it. |
404 | No upload with this id on your account. |
Code examples
cURL
curl https://api.wemail.io/v3/uploads/{id}/download \
-H "Authorization: Bearer afn_live_…"Node.js
const res = await fetch("https://api.wemail.io/v3/uploads/{id}/download", {
headers: {
Authorization: `Bearer ${process.env.WEMAIL_API_KEY}`,
},
});
const data = await res.json();Python
import os, requests
r = requests.get(
"https://api.wemail.io/v3/uploads/{id}/download",
headers={"Authorization": f"Bearer {os.environ['WEMAIL_API_KEY']}"},
)
data = r.json()