List members
Page through the members of a mailing list.
Members carry vars alongside their address — perfect for per-recipient personalisation in a single send.
GET /v3/lists/{address}/members
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page | integer | Optional | Page number, starting at 1. Default 1. |
per_page | integer | Optional | Members per page, 1–100. Default 25. |
subscribed | boolean | Optional | Pass subscribed=true to return only subscribed members. Omit the parameter to return everyone. |
Responses
| Status | Description |
|---|---|
200 | OK. A page of the list's members (address, name, vars, subscribed), oldest first. |
401 | Missing or invalid API key. |
404 | No mailing list at this address. |
Code examples
cURL
curl https://api.wemail.io/v3/lists/{address}/members \
-H "Authorization: Bearer afn_live_…"Node.js
const res = await fetch("https://api.wemail.io/v3/lists/{address}/members", {
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/lists/{address}/members",
headers={"Authorization": f"Bearer {os.environ['WEMAIL_API_KEY']}"},
)
data = r.json()