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.
search	string	Búsqueda por nombre, email o teléfono.
status	string	Filtra por estado (NEW, HOT, WARM, COLD, CONVERTED).
sort	string	Campo de orden (ej. createdAt).
order	string	asc o 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_TOKEN"

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_TOKEN' } }
);
const { data } = await res.json();

Python

import requests

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

Respuesta 200

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