Listar contactos

Devuelve los contactos de un workspace. Admite paginación, orden y filtros.

GET /workspaces/:workspaceId/contacts Copiar

Parámetros de ruta

Parámetro	Tipo	Descripción
workspaceId	string	Identificador del workspace.

Parámetros de query

Parámetro	Tipo	Descripción
page	number	Página (empieza en 1).
limit	number	Elementos por página (máx. 100).
search	string	Búsqueda por nombre, email o teléfono.
status	string	Filtra por estado (NEW, HOT, WARM, COLD, CONVERTED).
source	string	Filtra por origen del contacto.
tagIds	string	Uno o varios IDs de etiqueta (el contacto debe tener todas).
sortBy	string	name (por defecto), createdAt, updatedAt, lastMessageAt o company.
sortOrder	string	asc o desc (por defecto desc).

Consejo

Para exportaciones grandes, recorre las páginas con page/limit en vez de pedir todo de una vez.

cURL

curl "https://api.waiify.com/workspaces/WORKSPACE_ID/contacts?status=HOT&page=1&limit=25" \
  -H "Authorization: Bearer TU_API_KEY"

Node

const params = new URLSearchParams({ status: 'HOT', page: '1', limit: '25' });
const res = await fetch(
  `https://api.waiify.com/workspaces/WORKSPACE_ID/contacts?${params}`,
  { headers: { Authorization: 'Bearer TU_API_KEY' } }
);
const { data: contacts, pagination } = await res.json();

Python

import requests

res = requests.get(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/contacts",
    headers={"Authorization": "Bearer TU_API_KEY"},
    params={"status": "HOT", "page": 1, "limit": 25},
)
body = res.json()
contacts, pagination = body["data"], body["pagination"]

Respuesta 200

{
  "success": true,
  "data": [
    {
      "id": "contact_ab12cd34ef",
      "name": "Juan Pérez",
      "email": "juan@example.com",
      "phone": "+5215555555555",
      "status": "HOT",
      "createdAt": "2026-06-17T10:00:00.000Z"
    }
  ],
  "pagination": { "page": 1, "limit": 25, "total": 1, "totalPages": 1 }
}