Brazil Holidays & Business Days (Feriados e Dias Úteis)

Brazilian national and banking holidays from 2001 to 2099, plus business-day math: count business days between dates, add or subtract N business days, or list every business day in a period. Run one calculation at a time or thousands in a single run.

✅ Validated against the official ANBIMA calendar, the reference used by Brazilian banks and the financial market, for every year from 2001 to 2099, and cross-checked daily against an independent source to catch new holiday laws.

Why use it

• Payment due dates and settlements: when does a boleto due on a holiday actually fall due? What is D+2 from today?
• Interest calculations: Brazilian rates (CDI, Selic) accrue on business days in a 252-day year, so you need the exact business-day count (dias úteis).
• Deadlines and SLAs: add 5 business days to an order date, in bulk.
• Payroll and HR planning: holidays per year with weekday and legal basis.

No API key, no external dependency: holidays are computed (Easter-based dates included) and the results are deterministic.

Calendars

calendario	Non-business days	Use for
bancario (default)	Weekends + national holidays + Carnival (Mon & Tue) + Corpus Christi	Banks, payments, interest, most business contracts (same as ANBIMA)
nacional	Weekends + national holidays from federal law	Legal holidays only

National holidays: New Year, Good Friday, Tiradentes (Apr 21), Labour Day, Independence (Sep 7), Our Lady Aparecida (Oct 12), All Souls (Nov 2), Republic (Nov 15), Black Consciousness Day (Nov 20, national since 2024) and Christmas.

State and municipal holidays are not included yet.

How to use

1. Open this Actor in Apify Console (you can try it on Apify's free plan).
2. Fill in the input, or keep the example values to see how the output looks.
3. Click Start and wait for the run to finish.
4. Download the results as JSON, CSV or Excel from the run's output, or get them through the Apify API.
5. To get fresh data automatically, create an Apify Schedule for the Actor (for example, every morning).

Operations and examples

List holidays (feriados):

{ "operacao": "feriados", "anoInicial": 2026, "anoFinal": 2027 }

{ "data": "2026-02-16", "nome": "Carnaval (segunda-feira)", "tipo": "ponto_facultativo", "bancario": true,
  "naoUtil": true, "diaSemana": "segunda-feira", "caiEmFimDeSemana": false,
  "baseLegal": "Portaria federal anual", "calendario": "bancario" }

Count business days (contar_dias_uteis): market convention, start date excluded and end date included:

{ "operacao": "contar_dias_uteis", "dataInicial": "2026-01-01", "dataFinal": "2026-12-31" }

→ { "diasUteis": 249, "diasCorridos": 364, ... }

Add business days (somar_dias_uteis); negative values go back in time:

{ "operacao": "somar_dias_uteis", "data": "2026-12-23", "dias": 3 }

→ { "resultado": "2026-12-29", "diaSemanaResultado": "terça-feira", ... } (skips Christmas and the weekend)

Batch (lote): many calculations in one run, each with an optional id echoed back:

{
  "lote": [
    { "operacao": "somar_dias_uteis", "data": "2026-10-09", "dias": 5, "id": "invoice-1" },
    { "operacao": "contar_dias_uteis", "dataInicial": "2026-10-01", "dataFinal": "2026-10-31", "id": "oct" }
  ]
}

Invalid items in a batch return a row with an erro field and are not charged. The other items still run.

How much does it cost?

You pay US$ 0.0005 per row delivered to your dataset (US$ 0.50 per 1,000), plus a tiny start fee per run. Rows with input errors are free.

• One year of holidays (about 13 rows): about US$ 0.007.
• A batch of 1,000 business-day calculations: about US$ 0.50.

Notes

• Supported range: 2001–2099 (the validated range; the banking calendar before 2000 followed different rules).
• Carnival and Corpus Christi are formally pontos facultativos (optional federal days), but banks and the financial market do not operate on them. That is why they are non-business days in the bancario calendar.
• Ash Wednesday (Quarta-feira de Cinzas) is a half-day optional day and counts as a business day. Use incluirPontosFacultativos to list it.

FAQ

Can I use it from my code or an AI agent? Yes. Every Apify Actor can be called through the Apify API and the official clients, and AI agents can find and run it through the Apify MCP server.

Is the data official? Yes. It comes straight from the official public source listed under "Data source", with no manual edits.

Something broke or you need a field? Open an issue on the Actor's Issues tab.

Related Actors

More Brazilian public data from the same publisher:

• Brazil public tenders (PNCP Licitações): open and recently published government tenders, filtered by keyword, state, agency and value.
• Brazil government contracts and price records: contracts, purchase orders and price registration records (atas): who won, what, how much.
• Brazil government purchase prices: awarded unit prices and winning suppliers for any product or service, with price statistics.
• Brazil Central Bank indicators: Selic, CDI, IPCA, IGP-M, exchange rates and more, with accumulated totals.

---

🇧🇷 Resumo em português

Feriados nacionais e bancários de 2001 a 2099, validados contra o calendário oficial da ANBIMA, e cálculo de dias úteis: contar entre datas, somar ou subtrair N dias úteis e listar dias úteis, um por vez ou em lote. Inclui Carnaval e Corpus Christi no calendário bancário e o Dia da Consciência Negra (feriado nacional desde 2024). Você paga apenas pelos resultados.