Skip to main content
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"

[
  {
    "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"
  }
]

​
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

​
X-API-Key
string
required
Your Mindo API Key. Format: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

​
Query parameters

​
from
string
Start date (YYYY-MM-DD format, inclusive). Filters holidays with a date greater than or equal to this value.
​
to
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.
​
id
integer
Internal holiday ID.
​
company
integer
Company ID.
​
name
string
Holiday name.
​
description
string
Holiday description.
​
date
string
Holiday date (YYYY-MM-DD format).
​
branches
array
IDs of the branches the holiday applies to. Empty means it applies to all branches.
​
branchesDetail
array
Details of the branches the holiday applies to.
​
attentionTarget
string
Who the holiday applies to. Possible values: VIRTUAL_ATTENTION (virtual service), BRANCH (branch), ALL_BRANCHES (all branches), ALL (everyone).
​
hasCustomHours
boolean
If true, the holiday has reduced hours (startTime/finishAt) instead of a full closure.
​
startTime
string
Start time of the special hours (HH:MM:SS format). null if there are no special hours.
​
finishAt
string
End time of the special hours (HH:MM:SS format). null if there are no special hours.
​
isActive
boolean
Whether the holiday is active.
​
createdAt
string
Creation date (ISO 8601).
​
updatedAt
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"

[
  {
    "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"
  }
]