---
title: "Buscar Disponibilidad Completa"
method: POST
path: "/api/citas/buscar-disponibilidad-completa"
tags: ["copilot_frontend", "citas"]
---

# Buscar Disponibilidad Completa

`POST /api/citas/buscar-disponibilidad-completa`

## Request

- Base URL: `https://api.hogarsolar.es` (the document declares no server; this is the origin it was published from)
- URL: `https://api.hogarsolar.es/api/citas/buscar-disponibilidad-completa`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/hogarsolar/apis/hogarsolar-backend-api/docs/api/citas/buscar-disponibilidad-completa/post.ts> (a function with typed inputs; its response is checked against the schema)

Endpoint unificado que busca disponibilidad para visita, llamada y mantenimiento.

- **fecha_especifica**: busca slots en una sola fecha
- **proximos_dias**: busca slots en N días laborables (batch, 1 Google Calendar call por comercial)

El backend decide automáticamente:
- visita: priority por adyacencia a eventos existentes
- mantenimiento: priority por score de ruta + recomendaciones top 3
- llamada: todos los slots con priority "normal"

## Request body

- BuscarDisponibilidadCompletaRequest: Request unificado para buscar disponibilidad en todas las modalidades
  - `modalidad` string, required
  - `modo` string, required
  - `fecha` string, nullable
  - `fecha_inicio` string, nullable
  - `num_dias` integer
  - `cp_cliente` string, nullable
  - `comerciales_emails` string[], nullable

## Response `200`

Successful Response

- BuscarDisponibilidadCompletaResponse: Response unificado con slots, eventos, recomendaciones y priority
  - `comerciales` object, required
  - `modalidad_config` object, required
  - `slots_por_comercial` object, required
  - `eventos_por_comercial` object, required
  - `motivos_por_comercial` object
  - `recomendaciones` object[], nullable
  - `modo` string, required
  - `dias_buscados` integer, required

## 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.dev/hogarsolar/apis/hogarsolar-backend-api/revisions/b4cc3cebfaaa?raw)