Obtener lista con sus contactos

GET

/v1/bulk/lists/{id}

const url = 'https://api.mailerdash.com/v1/bulk/lists/example';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.mailerdash.com/v1/bulk/lists/example \
  --header 'Authorization: Bearer <token>'

Authorizations

BearerAuth

Parameters

Path Parameters

required

string

Query Parameters

limit

integer

offset

integer

status

string

Responses

200

Lista con contactos

application/json

object

string

name

string

key_id

string

contact_count

integer

created_at

string

contacts

Array<object>

object

integer

email

string

name

string

metadata

object

status

string

Allowed values: active unsubscribed bounced complained

key_id

string

created_at

string

updated_at

string

Example

{
  "id": "clientes-xipe-c76775",
  "name": "Clientes Xipe",
  "contact_count": 150,
  "contacts": [
    {
      "id": 1,
      "email": "cliente@empresa.com",
      "name": "Juan Perez",
      "metadata": {
        "empresa": "Xipe"
      },
      "status": "active",
      "key_id": "mi-app",
      "created_at": "2026-04-29T13:00:00.000Z",
      "updated_at": "2026-04-29T13:00:00.000Z"
    }
  ]
}

401

No autorizado

404

Lista no encontrada