Listar contactos

GET

/v1/bulk/contacts

const url = 'https://api.mailerdash.com/v1/bulk/contacts?limit=100&offset=0&format=csv';
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/contacts?limit=100&offset=0&format=csv' \
  --header 'Authorization: Bearer <token>'

Authorizations

BearerAuth

Parameters

Query Parameters

limit

integer

default: 100

offset

integer

status

string

key_id

string

search

string

format

string

Allowed values: csv

Responses

200

Lista de contactos

application/json

object

total

integer

items

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

{
  "items": [
    {
      "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