Feriados

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 autenticación 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 autenticación con API Key (header X-API-Key)"
}

Descripción

Este endpoint devuelve los feriados estipulados del negocio (días de cierre total o de horario reducido). Admite un filtro opcional por rango de fecha mediante los parámetros from y to. Es de solo lectura y está scopeado automáticamente a la empresa de la API Key utilizada.

Header de autenticación

string

requerido

Tu API Key de Mindo. Formato: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

Parámetros de query

string

Fecha desde (formato YYYY-MM-DD, inclusive). Filtra feriados con fecha mayor o igual.

string

Fecha hasta (formato YYYY-MM-DD, inclusive). Filtra feriados con fecha menor o igual.

Respuesta

Devuelve un array de feriados.

integer

ID interno del feriado.

integer

ID de la empresa.

string

Nombre del feriado.

string

Descripción del feriado.

string

Fecha del feriado (formato YYYY-MM-DD).

array

IDs de las sucursales a las que aplica el feriado. Vacío significa que aplica a todas las sucursales.

array

Detalle de las sucursales a las que aplica el feriado.

Mostrar Propiedades de branchesDetail

integer

ID interno de la sucursal.

integer

ID de la empresa.

string

Nombre de la sucursal.

string

Dirección de la sucursal.

string

Teléfono de la sucursal.

string

Tipo de sucursal: PHYSICAL u ONLINE.

string

Fecha de creación (ISO 8601).

string

Fecha de última actualización (ISO 8601).

string

A quién aplica el feriado. Valores posibles: VIRTUAL_ATTENTION (atención virtual), BRANCH (sucursal), ALL_BRANCHES (todas las sucursales), ALL (todos).

boolean

Si es true, el feriado tiene horario reducido (startTime/finishAt) en lugar de cierre total.

string

Hora de inicio del horario especial (formato HH:MM:SS). null si no tiene horario especial.

string

Hora de fin del horario especial (formato HH:MM:SS). null si no tiene horario especial.

boolean

Indica si el feriado está activo.

string

Fecha de creación (ISO 8601).

string

Fecha de última actualización (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 autenticación con API Key (header X-API-Key)"
}

Comenzar

Cuentas de negocio

Información del negocio

Mensajes

Contactos

Envío masivo

Exportación cualitativa

Descripción

Header de autenticación

Parámetros de query

Respuesta

​Descripción

​Header de autenticación

​Parámetros de query

​Respuesta

Descripción

Header de autenticación

Parámetros de query

Respuesta