---
title: "Consulta una lista de clientes"
method: GET
path: "/api/v1/clientes"
tags: ["Clientes"]
---

# Consulta una lista de clientes

`GET /api/v1/clientes`

Devuelve los clientes de la agencia aplicando los filtros indicados.



**Requisitos:**
- `clientes_read`

## Query parameters

- `TiposCliente` TipoCliente[] — Filtrar por tipo de cliente. (Ctrl para elegir varios)
- `IdGrupos` integer[] — Grupos a los que peretenecen los clientes (puedes ver tus grupos en el endpoint GetGrupos/Clientes)
- `IdExcluyeGrupos` integer[] — Grupos a los que no peretenecen los clientes (puedes ver tus grupos en el endpoint GetGrupos/Clientes)
- `IdCampana` integer — IdCampaña (puedes ver tus campañas en el endpoint GetCampañas)
- `UltimoContactoDesde` string, date-time — Fecha mínima (inclusive) del último contacto. (YYYY-MM-DD HH:MM:SS)
- `UltimoContactoHasta` string, date-time — Fecha máxima (inclusive) del último contacto. (YYYY-MM-DD HH:MM:SS)
- `IdCuenta` integer — IdCuenta (puedes ver tus cuentas en el endpoint GetCuentas)
- `FechaDesde` string, date-time — Fecha mínima (inclusive) desde la que traer registros de alta. (YYYY-MM-DD HH:MM:SS)
- `FechaHasta` string, date-time — Fecha máxima (inclusive) hasta la que traer registros de alta. (YYYY-MM-DD HH:MM:SS)
- `Busqueda` string — Texto de búsqueda por coincidencia parcial (contiene) sobre el nombre o el email del cliente. Si el texto contiene dígitos, se busca además en todos los teléfonos del cliente (móvil, teléfono 2 y teléfono 3); el número se normaliza antes de comparar (se admiten espacios y prefijo internacional +34 o 0034). No distingue mayúsculas de minúsculas.
- `OrdenarPor` 'FechaAlta' | 'NombreUsuario' | 'FechaUltimoContacto' | 'Referencia'
- `NumeroPagina` integer — Número de página a obtener (mínimo 1).
- `TamanoPagina` integer — Número de elementos por página (máximo 100).
- `Ordenacion` 'Ascendente' | 'Descendente'

## Response `200`

OK

- ClienteResponseApiCollectionPagedResponse
  - `elementos` ClienteResponse[], nullable
    - `idCliente` integer, nullable
    - `referencia` integer, nullable
    - `dni` string, nullable
    - `nombre` string, nullable
    - `email` string, nullable
    - `alias` string, nullable
    - `direccion` string, nullable
    - `codigoPostal` string, nullable
    - `urlWeb` string, nullable
    - `observaciones` string, nullable
    - `telefonoMovil` string, nullable
    - `telefono2` string, nullable
    - `telefono3` string, nullable
    - `estadoCivil` 'Soltero' | 'Casado' | 'Viudo' | 'Divorciado' | 'Separado' | 'ParejaDeHecho'
    - `idiomaComunicacion` string, nullable
    - `idAgenteCrea` integer, nullable
    - `idAgenteModifica` integer, nullable
    - `recibirAlertasEmail` boolean, nullable
    - `recibirEmailManuales` boolean, nullable
    - `propietario` boolean, nullable
    - `demandante` boolean, nullable
    - `tipoCliente` boolean, nullable
    - `tipoNewsletter` boolean, nullable
    - `idCampana` integer, nullable
    - `fechaUltimoContacto` string, date-time, nullable
    - `fechaAlta` string, date-time, nullable
    - `grupos` integer[], nullable
    - `cuentas` integer[], nullable
  - `totalElementos` integer
  - `pagina` integer
  - `tamanoPagina` integer

---

[API](https://skmtc.net/mobiliagestion/apis/mobilia-public-api.md) · [All operations](https://skmtc.net/mobiliagestion/apis/mobilia-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobiliagestion/mobilia-public-api/versions/acbeb97ad5a7/schema)