Pular para o conteúdo principal
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"
  }
]

​
Descrição

Este endpoint retorna os feriados estipulados do negócio (dias de fechamento total ou de horário reduzido). Aceita um filtro opcional por intervalo de datas através dos parâmetros from e to. É somente leitura e está automaticamente restrito à empresa da API Key utilizada.

​
Header de autenticação

​
X-API-Key
string
obrigatório
Sua API Key da Mindo. Formato: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

​
Parâmetros de query

​
from
string
Data inicial (formato YYYY-MM-DD, inclusive). Filtra feriados com data maior ou igual.
​
to
string
Data final (formato YYYY-MM-DD, inclusive). Filtra feriados com data menor ou igual.

​
Resposta

Retorna um array de feriados.
​
id
integer
ID interno do feriado.
​
company
integer
ID da empresa.
​
name
string
Nome do feriado.
​
description
string
Descrição do feriado.
​
date
string
Data do feriado (formato YYYY-MM-DD).
​
branches
array
IDs das filiais às quais o feriado se aplica. Vazio significa que se aplica a todas as filiais.
​
branchesDetail
array
Detalhe das filiais às quais o feriado se aplica.
​
attentionTarget
string
A quem o feriado se aplica. Valores possíveis: VIRTUAL_ATTENTION (atendimento virtual), BRANCH (filial), ALL_BRANCHES (todas as filiais), ALL (todos).
​
hasCustomHours
boolean
Se for true, o feriado tem horário reduzido (startTime/finishAt) em vez de fechamento total.
​
startTime
string
Hora de início do horário especial (formato HH:MM:SS). null se não tiver horário especial.
​
finishAt
string
Hora de término do horário especial (formato HH:MM:SS). null se não tiver horário especial.
​
isActive
boolean
Indica se o feriado está ativo.
​
createdAt
string
Data de criação (ISO 8601).
​
updatedAt
string
Data da última atualização (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"
  }
]