---
title: "contacts__getContacts"
method: POST
path: "/tools/contacts__getContacts"
tags: ["Contacts"]
---

# contacts__getContacts

`POST /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`.

## Request body

- object
  - `limit` integer — Cantidad máxima de contactos a retornar. El servidor MCP fuerza un tope de 30.
  - `start` integer — Offset para paginación (número de contactos a omitir desde el inicio).
  - `order_direction` 'ASC' | 'DESC' — Dirección del ordenamiento.
  - `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` 'client' | 'provider' — Filtra por tipo de contacto. Si se omite, retorna ambos.
  - `mode` 'advanced' | 'simple' — Modo de respuesta: `simple` retorna un subconjunto de campos; `advanced` retorna el contacto completo.

## Response `200`

Lista de contactos.

## Other responses

- `401` — No autorizado (token de Alegra inválido o expirado).

---

[API](https://skmtc.net/alegra/apis/ingresos.md) · [All operations](https://skmtc.net/alegra/apis/ingresos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/ingresos/revisions/cd52d3f68f1b/schema)