---
title: "Get Contact By Email With Details"
method: GET
path: "/api/citas/contacts/get-by-email"
tags: ["copilot_frontend", "citas"]
---

# Get Contact By Email With Details

`GET /api/citas/contacts/get-by-email`

**Endpoint Unificado:** Busca un contacto por email y devuelve toda su información incluida la dirección.

Este endpoint combina las operaciones de:
1. Buscar contacto por email (/contacts/search)
2. Obtener dirección del contacto (/contacts/{id}/address)

En una sola llamada, optimizando el rendimiento del frontend.

**🔒 Endpoint Protegido:** Requiere autenticación JWT y rol 'ui_hubspot', 'admin', 'ui_citas' o 'ui_mantenimiento'

Args:
    email: Email del contacto a buscar

Returns:
    ContactDetailsResponse con todos los datos del contacto

Raises:
    404: Si el contacto no existe
    500: Error interno del servidor

## Query parameters

- `email` string, required

## Response `200`

Successful Response

- ContactDetailsResponse — Respuesta con los detalles completos de un contacto incluida la dirección
  - `id` string, required
  - `firstname` string, nullable
  - `lastname` string, nullable
  - `email` string, nullable
  - `phone` string, nullable
  - `address` string, nullable
  - `city` string, nullable
  - `zip` string, nullable
  - `province` string, nullable
  - `numero_documento_identidad` string, nullable
  - `tipo_documento` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/hogarsolar/apis/hogarsolar-backend-api.md) · [All operations](https://skmtc.dev/hogarsolar/apis/hogarsolar-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hogarsolar/hogarsolar-backend-api/revisions/d9861e46bef8/schema)