DIAS ÚTEIS

Dias úteis

Conta os dias úteis entre duas datas, descontando fins de semana e, por padrão, feriados nacionais.

Business days

Counts business days between two dates, discounting weekends and, by default, national holidays.

SYNC resposta na mesma chamada answers in the same call

Endpoints

GET /api/v1/diasuteis lista os dias úteis entre duas datas lists the business days between two dates

Parâmetros

Parameters

Nome	Name	Onde	In	Descrição	Description
`data_inicial`, `data_final`	query	obrigatórios, formato `YYYY-MM-DD`, intervalo inclusivo, máximo de 10 anos	required, `YYYY-MM-DD` format, inclusive range, capped at 10 years
`feriados`	query	opcional, default `true` — `false` conta feriados nacionais como dia útil, descontando só fim de semana	optional, default `true` — `false` counts national holidays as business days, discounting only weekends

Exemplo

Example

curl "https://api.alicercelabs.com.br/api/v1/diasuteis?data_inicial=2026-01-01&data_final=2026-01-10" \
          -H "Authorization: Bearer <token>"

{
          "success": true,
          "data": {
            "dias_uteis": ["2026-01-02", "2026-01-05", "2026-01-06", "2026-01-07", "2026-01-08", "2026-01-09"],
            "total": 6
          },
          "meta": { "elapsed_ms": 0, "request_id": "..." }
        }

1º de janeiro é feriado nacional, por isso não entra na contagem apesar de ser dia de semana.

January 1st is a national holiday, so it's excluded from the count despite falling on a weekday.

Erros possíveis

Possible errors

Status	Motivo	Reason
400	datas ausentes/mal formatadas, `data_final` anterior a `data_inicial`, ou intervalo maior que 10 anos	missing/malformed dates, `data_final` before `data_inicial`, or a range longer than 10 years
401	token ausente ou inválido	missing or invalid token
429	limite de taxa excedido	rate limit exceeded

Deriva de Feriados

Derives from Feriados

Usa o mesmo motor da API de Feriados, chamado direto dentro do mesmo processo Go — não é uma segunda chamada HTTP. Isso também significa: sem fonte externa, sem cache, e a mesma limitação de cobrir só feriados nacionais (sem estaduais nesta versão).

Uses the same engine as the Feriados API, called directly within the same Go process — not a second HTTP call. That also means: no external source, no cache, and the same limitation of covering only national holidays (no state ones in this version).

Usando o SDK

Using the SDK

SDKs oficiais: Go · Python · JavaScript.

Official SDKs: Go · Python · JavaScript.

Contar dias úteis

Count business days

import (
	"context"
	"fmt"

	alicercelabs "github.com/alicercelabs/alicercesdk-go"
)

client := alicercelabs.New("alk_...") // ou um token JWT de login/register
ctx := context.Background()

result, err := client.DiasUteis.Count(ctx, "2026-01-01", "2026-01-31", nil)
if err != nil {
	panic(err)
}
fmt.Println(result.Total)

from alicercelabs import AlicerceLabs

client = AlicerceLabs(api_key="alk_...")  # ou um token JWT de login/register

result = client.diasuteis.count("2026-01-01", "2026-01-31")
print(result["total"])

import { AlicerceLabs } from "alicercesdk-javascript";

const client = new AlicerceLabs("alk_..."); // ou um token JWT de login/register

const result = await client.diasUteis.count("2026-01-01", "2026-01-31");
console.log(result.total);

Limites

Limits

100/dia · 4/hora sem token, por IP chamador; com token (JWT de login ou API key gerada no painel), 1.000/dia · 41/hora.

100/day · 4/hour without a token, per calling IP; with one (a login JWT or an API key generated in the panel), 1,000/day · 41/hour.