> ## 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.

# Horários de atendimento

> Obtém os horários fixos do negócio agrupados por filial

## Descrição

Este endpoint retorna os horários fixos de atendimento do negócio, **agrupados por filial**. Cada filial traz sua lista de horários.

Os horários podem ser recorrentes semanais (campo `days`) ou de uma data específica (`specificDate`). Este endpoint **não** filtra por intervalo de datas: retorna toda a configuração de horários. Para datas especiais de fechamento ou atendimento reduzido, consulte o endpoint de [feriados](/pt/api-reference/informacion-negocio/feriados).

## Header de autenticação

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

## Resposta

Retorna um **array** de filiais.

<ResponseField name="branchId" type="integer">
  ID interno da filial.
</ResponseField>

<ResponseField name="branchName" type="string">
  Nome da filial.
</ResponseField>

<ResponseField name="branchType" type="string">
  Tipo de filial. Valores possíveis: `PHYSICAL` (filial física), `ONLINE` (atendimento online).
</ResponseField>

<ResponseField name="address" type="string">
  Endereço da filial.
</ResponseField>

<ResponseField name="schedules" type="array">
  Horários fixos da filial.

  <Expandable title="Propriedades de schedules">
    <ResponseField name="id" type="integer">
      ID interno do horário.
    </ResponseField>

    <ResponseField name="days" type="array">
      Dias da semana em que o horário se aplica (recorrente). Valores: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`. Vazio se for um horário de data específica.
    </ResponseField>

    <ResponseField name="daysDisplay" type="string">
      Rótulo legível dos dias (ex. `Lunes, Martes, Miércoles`).
    </ResponseField>

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

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

    <ResponseField name="isActive" type="boolean">
      Indica se o horário está ativo.
    </ResponseField>

    <ResponseField name="description" type="string">
      Descrição opcional do horário.
    </ResponseField>

    <ResponseField name="specificDate" type="string">
      Data específica do horário (formato `YYYY-MM-DD`) se não for recorrente. `null` para horários semanais.
    </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 não enviada theme={null}
  {
    "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
  }
  ```
</ResponseExample>