---
title: "Consulta un agente"
method: GET
path: "/api/v1/agentes/by-email"
tags: ["Agentes"]
---

# Consulta un agente

`GET /api/v1/agentes/by-email`

## Request

- Base URL: `https://api.mobiliagestion.es` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mobiliagestion.es/api/v1/agentes/by-email`
- Auth: API key in header `Authorization`

Devuelve la información del agente a partir de su **email**.

**Notas:**
- Devuelve únicamente los agentes **activos**: un agente inactivo responde **404**, igual que un agente inexistente.


**Requisitos:**
- `agentes_read`

## Query parameters

- `email` string

## Response `200`

OK

- AgenteResponseApiResponse
  - `datos` AgenteResponse
    - `idAgente` integer
    - `nombreUsuario` string, nullable
    - `email` string, nullable
    - `roles` string[], nullable

## Other responses

- `404`: Not Found

---

[API](https://skmtc.dev/mobiliagestion/apis/mobilia-public-api.md) - [All operations](https://skmtc.dev/mobiliagestion/apis/mobilia-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mobiliagestion/apis/mobilia-public-api/revisions/d893803b00d5?raw)