List hosted uploads
List your hosted uploads and storage usage.
Returns your hosted uploads (latest 200, newest first) together with your storage usage: used_bytes counts every live upload — deleted and expired files don't count — against quota_bytes (100 MB included on paid plans; storage add-ons raise it — free plans have no hosted-upload storage).
GET /v3/uploads
Response fields
| Parameter | Type | Required | Description |
|---|---|---|---|
items | array | Optional | Upload objects: id, filename, content_type, size_bytes, url, download_count, expires_at, created_at. |
used_bytes | number | Optional | Bytes currently counting toward your storage quota. |
quota_bytes | number | Optional | Your plan's storage quota in bytes. |
Responses
| Status | Description |
|---|---|
200 | OK. Your hosted uploads (latest 200, newest first) plus used_bytes and your plan's quota_bytes. |
401 | Missing or invalid API key. |
503 | Hosted uploads are not configured on this deployment. |
Code examples
cURL
curl https://api.wemail.io/v3/uploads \
-H "Authorization: Bearer afn_live_…"Node.js
const res = await fetch("https://api.wemail.io/v3/uploads", {
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",
headers={"Authorization": f"Bearer {os.environ['WEMAIL_API_KEY']}"},
)
data = r.json()