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

# Consulta una lista de agentes

`GET /api/v1/agentes`

Devuelve los agentes de la agencia.

**Notas:**
- Devuelve únicamente los agentes **activos**.



**Requisitos:**
- `agentes_read`

## Query parameters

- `Busqueda` string — Texto para buscar por nombre, email e idAgente
- `OrdenarPor` 'IdAgente' | 'NombreUsuario' | 'Email'
- `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

- AgenteResponseApiCollectionPagedResponse
  - `elementos` AgenteResponse[], nullable
    - `idAgente` integer
    - `nombreUsuario` string, nullable
    - `email` string, nullable
    - `roles` string[], 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)