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

# Business hours

> Get the business's fixed hours grouped by branch

## Description

This endpoint returns the business's fixed operating hours, **grouped by branch**. Each branch includes its list of schedules.

Schedules can be weekly recurring (`days` field) or for a specific date (`specificDate`). This endpoint does **not** filter by date range: it returns the entire hours configuration. For special closing dates or reduced-hours days, see the [holidays](/en/api-reference/informacion-negocio/feriados) endpoint.

## Authentication header

<ParamField header="X-API-Key" type="string" required>
  Your Mindo API Key. Format: `mindo_xxxxxxxxxxxxxxxxxxxxxxxx`
</ParamField>

## Response

Returns an **array** of branches.

<ResponseField name="branchId" type="integer">
  Internal branch ID.
</ResponseField>

<ResponseField name="branchName" type="string">
  Branch name.
</ResponseField>

<ResponseField name="branchType" type="string">
  Branch type. Possible values: `PHYSICAL` (physical branch), `ONLINE` (online service).
</ResponseField>

<ResponseField name="address" type="string">
  Branch address.
</ResponseField>

<ResponseField name="schedules" type="array">
  Fixed schedules of the branch.

  <Expandable title="schedules properties">
    <ResponseField name="id" type="integer">
      Internal schedule ID.
    </ResponseField>

    <ResponseField name="days" type="array">
      Days of the week the schedule applies to (recurring). Values: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`. Empty if it is a specific-date schedule.
    </ResponseField>

    <ResponseField name="daysDisplay" type="string">
      Human-readable label of the days (e.g. `Lunes, Martes, Miércoles`).
    </ResponseField>

    <ResponseField name="startTime" type="string">
      Start time (`HH:MM:SS` format).
    </ResponseField>

    <ResponseField name="finishAt" type="string">
      End time (`HH:MM:SS` format).
    </ResponseField>

    <ResponseField name="isActive" type="boolean">
      Whether the schedule is active.
    </ResponseField>

    <ResponseField name="description" type="string">
      Optional schedule description.
    </ResponseField>

    <ResponseField name="specificDate" type="string">
      Specific date of the schedule (`YYYY-MM-DD` format) if it is not recurring. `null` for weekly schedules.
    </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 not sent theme={null}
  {
    "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
  }
  ```
</ResponseExample>