Mailriser is in open beta. Learn more.

Mailriser Documentation

Lists API
Learn about the Lists API and how to use it.

The Lists API is the api you can use to fetch your lists.

The Lists API uses /api/lists as the base.

Fetch all Lists

To fetch all your lists, use the /fetch endpoint. It doesn't require any data.

Here's an example request in Node:

const key = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX";

const base = "https://mailriser.com/api";
const endpoint = "/lists/fetch";

const data = {};

const request = await fetch(base + endpoint, {
    method: "POST",
    headers: {
        Authorization: key,
        "Content-Type": "application/json"
    },
    body: JSON.stringify(data)
});

const response = await request.json();

console.log(response);
{
    "success": true,
    "data": [
        {
            "id": 1,
            "name": "My Newsletter",
            "description": "My newsletter description",
            "subscribers": 100
        }
    ]
}
Table of Contents