Get a hosted upload

Retrieve one hosted upload, including its download count.

Retrieve a hosted upload by id. download_count increments on every download of the hosted url, so this is also a lightweight engagement signal — and when the URL is clicked from a tracked message, each download additionally appears as a clicked event with the recipient attributed.

GET /v3/uploads/{id}

Path parameters

ParameterTypeRequiredDescription
idstringRequiredThe upload id returned by POST /v3/uploads — always starts with up_ (e.g. up_9f3KzQ7wXt2mB4hN).

Responses

StatusDescription
200The upload object.
404No upload with this id on your account.

Code examples

cURL
curl https://api.wemail.io/v3/uploads/{id} \
  -H "Authorization: Bearer afn_live_…"
Node.js
const res = await fetch("https://api.wemail.io/v3/uploads/{id}", {
  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}",
    headers={"Authorization": f"Bearer {os.environ['WEMAIL_API_KEY']}"},
)
data = r.json()