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)"
}
Business info
Holidays
Get the business’s defined holidays, with an optional date range filter
GET
/
api
/
v1
/
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 thefrom 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_xxxxxxxxxxxxxxxxxxxxxxxxQuery 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
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)"
}