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

ParameterTypeRequiredDescription
pageintegerOptionalPage number, starting at 1. Default 1.
per_pageintegerOptionalMembers per page, 1–100. Default 25.
subscribedbooleanOptionalPass subscribed=true to return only subscribed members. Omit the parameter to return everyone.

Responses

StatusDescription
200OK. A page of the list's members (address, name, vars, subscribed), oldest first.
401Missing or invalid API key.
404No 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()