Holidays

curl -X GET "https://api.mindosoftware.com/api/v1/holidays/?from=2026-01-01&to=2026-12-31" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

import requests

response = requests.get(
    "https://api.mindosoftware.com/api/v1/holidays/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"},
    params={"from": "2026-01-01", "to": "2026-12-31"}
)

data = response.json()
print(data)

const params = new URLSearchParams({ from: "2026-01-01", to: "2026-12-31" });
const response = await fetch(
  `https://api.mindosoftware.com/api/v1/holidays/?${params}`,
  {
    headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
  }
);

const data = await response.json();
console.log(data);

[
  {
    "id": 8,
    "company": 12,
    "name": "Año Nuevo",
    "description": "Cerrado todo el día",
    "date": "2026-01-01",
    "branches": [],
    "branchesDetail": [],
    "attentionTarget": "ALL",
    "hasCustomHours": false,
    "startTime": null,
    "finishAt": null,
    "isActive": true,
    "createdAt": "2025-12-10T14:30:00Z",
    "updatedAt": "2025-12-10T14:30:00Z"
  },
  {
    "id": 9,
    "company": 12,
    "name": "Nochebuena",
    "description": "Horario reducido",
    "date": "2026-12-24",
    "branches": [5],
    "branchesDetail": [
      {
        "id": 5,
        "company": 12,
        "name": "Casa Central",
        "address": "Av. Siempre Viva 123, Mar del Plata",
        "phone": "+54 9 223 675-0780",
        "branchType": "PHYSICAL",
        "createdAt": "2025-11-01T10:00:00Z",
        "updatedAt": "2025-11-01T10:00:00Z"
      }
    ],
    "attentionTarget": "BRANCH",
    "hasCustomHours": true,
    "startTime": "09:00:00",
    "finishAt": "13:00:00",
    "isActive": true,
    "createdAt": "2025-12-10T14:35:00Z",
    "updatedAt": "2025-12-10T14:35:00Z"
  }
]

{
  "error": "Parámetro 'from' con formato de fecha inválido. Use YYYY-MM-DD."
}

{
  "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}

GET

api

holidays

curl -X GET "https://api.mindosoftware.com/api/v1/holidays/?from=2026-01-01&to=2026-12-31" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

import requests

response = requests.get(
    "https://api.mindosoftware.com/api/v1/holidays/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"},
    params={"from": "2026-01-01", "to": "2026-12-31"}
)

data = response.json()
print(data)

const params = new URLSearchParams({ from: "2026-01-01", to: "2026-12-31" });
const response = await fetch(
  `https://api.mindosoftware.com/api/v1/holidays/?${params}`,
  {
    headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
  }
);

const data = await response.json();
console.log(data);

[
  {
    "id": 8,
    "company": 12,
    "name": "Año Nuevo",
    "description": "Cerrado todo el día",
    "date": "2026-01-01",
    "branches": [],
    "branchesDetail": [],
    "attentionTarget": "ALL",
    "hasCustomHours": false,
    "startTime": null,
    "finishAt": null,
    "isActive": true,
    "createdAt": "2025-12-10T14:30:00Z",
    "updatedAt": "2025-12-10T14:30:00Z"
  },
  {
    "id": 9,
    "company": 12,
    "name": "Nochebuena",
    "description": "Horario reducido",
    "date": "2026-12-24",
    "branches": [5],
    "branchesDetail": [
      {
        "id": 5,
        "company": 12,
        "name": "Casa Central",
        "address": "Av. Siempre Viva 123, Mar del Plata",
        "phone": "+54 9 223 675-0780",
        "branchType": "PHYSICAL",
        "createdAt": "2025-11-01T10:00:00Z",
        "updatedAt": "2025-11-01T10:00:00Z"
      }
    ],
    "attentionTarget": "BRANCH",
    "hasCustomHours": true,
    "startTime": "09:00:00",
    "finishAt": "13:00:00",
    "isActive": true,
    "createdAt": "2025-12-10T14:35:00Z",
    "updatedAt": "2025-12-10T14:35:00Z"
  }
]

{
  "error": "Parámetro 'from' con formato de fecha inválido. Use YYYY-MM-DD."
}

{
  "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}

Description

This endpoint returns the business’s defined holidays (full-closure days or reduced-hours days). It supports an optional date range filter via the from and to parameters. It is read-only and is automatically scoped to the company of the API Key used.

Authentication header

string

required

Your Mindo API Key. Format: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

Query parameters

string

Start date (YYYY-MM-DD format, inclusive). Filters holidays with a date greater than or equal to this value.

string

End date (YYYY-MM-DD format, inclusive). Filters holidays with a date less than or equal to this value.

Response

Returns an array of holidays.

integer

Internal holiday ID.

integer

Company ID.

string

Holiday name.

string

Holiday description.

string

Holiday date (YYYY-MM-DD format).

array

IDs of the branches the holiday applies to. Empty means it applies to all branches.

array

Details of the branches the holiday applies to.

Show branchesDetail properties

integer

Internal branch ID.

integer

Company ID.

string

Branch name.

string

Branch address.

string

Branch phone.

string

Branch type: PHYSICAL or ONLINE.

string

Creation date (ISO 8601).

string

Last update date (ISO 8601).

string

Who the holiday applies to. Possible values: VIRTUAL_ATTENTION (virtual service), BRANCH (branch), ALL_BRANCHES (all branches), ALL (everyone).

boolean

If true, the holiday has reduced hours (startTime/finishAt) instead of a full closure.

string

Start time of the special hours (HH:MM:SS format). null if there are no special hours.

string

End time of the special hours (HH:MM:SS format). null if there are no special hours.

boolean

Whether the holiday is active.

string

Creation date (ISO 8601).

string

Last update date (ISO 8601).

curl -X GET "https://api.mindosoftware.com/api/v1/holidays/?from=2026-01-01&to=2026-12-31" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

import requests

response = requests.get(
    "https://api.mindosoftware.com/api/v1/holidays/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"},
    params={"from": "2026-01-01", "to": "2026-12-31"}
)

data = response.json()
print(data)

const params = new URLSearchParams({ from: "2026-01-01", to: "2026-12-31" });
const response = await fetch(
  `https://api.mindosoftware.com/api/v1/holidays/?${params}`,
  {
    headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
  }
);

const data = await response.json();
console.log(data);

[
  {
    "id": 8,
    "company": 12,
    "name": "Año Nuevo",
    "description": "Cerrado todo el día",
    "date": "2026-01-01",
    "branches": [],
    "branchesDetail": [],
    "attentionTarget": "ALL",
    "hasCustomHours": false,
    "startTime": null,
    "finishAt": null,
    "isActive": true,
    "createdAt": "2025-12-10T14:30:00Z",
    "updatedAt": "2025-12-10T14:30:00Z"
  },
  {
    "id": 9,
    "company": 12,
    "name": "Nochebuena",
    "description": "Horario reducido",
    "date": "2026-12-24",
    "branches": [5],
    "branchesDetail": [
      {
        "id": 5,
        "company": 12,
        "name": "Casa Central",
        "address": "Av. Siempre Viva 123, Mar del Plata",
        "phone": "+54 9 223 675-0780",
        "branchType": "PHYSICAL",
        "createdAt": "2025-11-01T10:00:00Z",
        "updatedAt": "2025-11-01T10:00:00Z"
      }
    ],
    "attentionTarget": "BRANCH",
    "hasCustomHours": true,
    "startTime": "09:00:00",
    "finishAt": "13:00:00",
    "isActive": true,
    "createdAt": "2025-12-10T14:35:00Z",
    "updatedAt": "2025-12-10T14:35:00Z"
  }
]

{
  "error": "Parámetro 'from' con formato de fecha inválido. Use YYYY-MM-DD."
}

{
  "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}

Get started

Business accounts

Business info

Messages

Contacts

Bulk sending

Qualitative export

Description

Authentication header

Query parameters

Response

​Description

​Authentication header

​Query parameters

​Response

Description

Authentication header

Query parameters

Response