contacts__getContacts

post

https://mcp.alegra.com/tools/contacts__getContacts

Lista los contactos (clientes y/o proveedores) de la cuenta con filtros y paginación. Equivale a GET /contacts de la API de Alegra. El parámetro mode=advanced retorna objetos completos; mode=simple retorna un subconjunto reducido. Para búsquedas por texto libre usar query; para encontrar exactamente por documento, identification.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

limit

integer

0 to 30

Defaults to 30

Cantidad máxima de contactos a retornar. El servidor MCP fuerza un tope de 30.

start

integer

≥ 0

Defaults to 0

Offset para paginación (número de contactos a omitir desde el inicio).

order_direction

string

enum

Dirección del ordenamiento.

Allowed:

order_field

string

Campo por el cual ordenar (p. ej. name, id, identification).

query

string

Texto libre. Busca coincidencias en nombre, identificación, email, etc.

identification

string

Filtra por número de identificación exacto (NIT, cédula, RFC, según país).

name

string

Filtra por nombre del contacto.

type

string

enum

Filtra por tipo de contacto. Si se omite, retorna ambos.

Allowed:

mode

string

enum

Modo de respuesta: simple retorna un subconjunto de campos; advanced retorna el contacto completo.

Allowed:

Responses

401

No autorizado (token de Alegra inválido o expirado).

200Lista de contactos.