> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindosoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Horarios de atención

> Obtiene los horarios fijos del negocio agrupados por sucursal

## Descripción

Este endpoint devuelve los horarios fijos de atención del negocio, **agrupados por sucursal**. Cada sucursal trae su lista de horarios.

Los horarios pueden ser recurrentes semanales (campo `days`) o de una fecha específica (`specificDate`). Este endpoint **no** filtra por rango de fecha: devuelve toda la configuración de horarios. Para fechas especiales de cierre o atención reducida, ver el endpoint de [feriados](/api-reference/informacion-negocio/feriados).

## Header de autenticación

<ParamField header="X-API-Key" type="string" required>
  Tu API Key de Mindo. Formato: `mindo_xxxxxxxxxxxxxxxxxxxxxxxx`
</ParamField>

## Respuesta

Devuelve un **array** de sucursales.

<ResponseField name="branchId" type="integer">
  ID interno de la sucursal.
</ResponseField>

<ResponseField name="branchName" type="string">
  Nombre de la sucursal.
</ResponseField>

<ResponseField name="branchType" type="string">
  Tipo de sucursal. Valores posibles: `PHYSICAL` (sucursal física), `ONLINE` (atención online).
</ResponseField>

<ResponseField name="address" type="string">
  Dirección de la sucursal.
</ResponseField>

<ResponseField name="schedules" type="array">
  Horarios fijos de la sucursal.

  <Expandable title="Propiedades de schedules">
    <ResponseField name="id" type="integer">
      ID interno del horario.
    </ResponseField>

    <ResponseField name="days" type="array">
      Días de la semana en los que aplica el horario (recurrente). Valores: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`. Vacío si es un horario de fecha específica.
    </ResponseField>

    <ResponseField name="daysDisplay" type="string">
      Etiqueta legible de los días (ej. `Lunes, Martes, Miércoles`).
    </ResponseField>

    <ResponseField name="startTime" type="string">
      Hora de inicio (formato `HH:MM:SS`).
    </ResponseField>

    <ResponseField name="finishAt" type="string">
      Hora de fin (formato `HH:MM:SS`).
    </ResponseField>

    <ResponseField name="isActive" type="boolean">
      Indica si el horario está activo.
    </ResponseField>

    <ResponseField name="description" type="string">
      Descripción opcional del horario.
    </ResponseField>

    <ResponseField name="specificDate" type="string">
      Fecha específica del horario (formato `YYYY-MM-DD`) si no es recurrente. `null` para horarios semanales.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://api.mindosoftware.com/api/v1/business-hours/ \
    -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.mindosoftware.com/api/v1/business-hours/",
      headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
  )

  data = response.json()
  print(data)
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://api.mindosoftware.com/api/v1/business-hours/",
    {
      headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - OK theme={null}
  [
    {
      "branchId": 5,
      "branchName": "Casa Central",
      "branchType": "PHYSICAL",
      "address": "Av. Siempre Viva 123, Mar del Plata",
      "schedules": [
        {
          "id": 41,
          "days": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY"],
          "daysDisplay": "Lunes, Martes, Miércoles, Jueves, Viernes",
          "startTime": "09:00:00",
          "finishAt": "18:00:00",
          "isActive": true,
          "description": "Horario de semana",
          "specificDate": null
        },
        {
          "id": 42,
          "days": ["SATURDAY"],
          "daysDisplay": "Sábado",
          "startTime": "09:00:00",
          "finishAt": "13:00:00",
          "isActive": true,
          "description": "",
          "specificDate": null
        }
      ]
    }
  ]
  ```

  ```json 401 - API Key no enviada theme={null}
  {
    "error": "Este endpoint requiere autenticación con API Key (header X-API-Key)"
  }
  ```
</ResponseExample>