Skip to main content
GET
Listar contactos

Autorizaciones

Authorization
string
header
requerido

Token JWT de autenticação

Encabezados

x-company-id
string

Identificador de la empresa objetivo. Obligatorio solo para API keys globales (type=global). Se ignora para API keys de empresa y usuarios humanos.

Parámetros de consulta

Término de búsqueda para filtrar contactos. Busca por: ID del contacto (ObjectId exacto), nombre (parcial, case-insensitive), e-mail (parcial, case-insensitive) o número de teléfono (parcial). Ejemplos: "João", "joao@email.com", "11999998888", "507f1f77bcf86cd799439011".

filters
string

Filtros opcionales (JSON array). Cada elemento: { field, operator, value }. field: contact. (name, email, phone_number, country_code, linkedin_identifier) o ObjectId del campo personalizado. Operadores: eq, neq, contains, not_contains, starts_with, ends_with, is_empty, is_not_empty.

skip_count
string

Cuando es true, omite el conteo total (totalCount llega null). Para búsquedas de UI que no paginan — en tenants grandes el count es la parte más costosa de la búsqueda.

page
string
predeterminado:1

Número de página (empieza en 1)

rowsPerPage
string
predeterminado:10

Cantidad de elementos por página

Respuesta

Lista de contactos devuelta correctamente

result
any[]
requerido

Lista de contactos

meta
any
requerido

Metadatos de la paginación