Brazilian HolidaysREST JSON API
Why choose our API?
The most complete and reliable solution for managing Brazilian holidays in your system
Complete Municipal Coverage
Access all 13,500+ yearly holidays across all 5,571 Brazilian municipalities with official IBGE codes.
Always Up-to-Date
Our team monitors official government gazettes across Brazil to keep data constantly updated with new decrees and legislative changes.
Compliance & Banking Calendar
Data validated against current legislation and official FEBRABAN banking calendar (CMN Resolution 4,880). Check business days and calculate due dates.
High Availability & Low Latency
99.9% SLA with <50ms average latency, redundant infrastructure, and 24/7 monitoring.
History and Future (2010 to 2100)
Access 90+ years of coverage: retroactive history since 2010 and projections through 2100 with automated movable holiday calculations.
Simple REST API & Native MCP
Easy integration in any language plus native support for AI agents via Model Context Protocol (MCP).
The difference is in municipal holidays
Over 13,500 holidays occur in Brazil every year. While national and state holidays are few, municipal holidays change constantly via local decrees
- Manually researching municipal decrees
- Maintaining spreadsheets with 13,000+ yearly holidays
- Risk of outdated data across 5,571 municipalities
- Payroll, delivery deadline, and banking slip errors
- Hours of manual rework with every new local decree
- One single REST call for any Brazilian municipality
- 13,500+ holidays/year automatically kept up to date
- Validated against Official Gazettes and FEBRABAN calendar
- Coverage from 2010 to 2100 with automated movable holiday calculations
- Integrates in minutes with full regulatory compliance
Official Gazettes & Decrees
We monitor official municipal, state, and federal gazettes daily to capture new holidays and optional days as soon as they are decreed.
FEBRABAN Banking Calendar
Fully compliant with CMN Resolution 4,880 for accurate calculation of banking business days, invoice due dates, and financial settlement.
Official IBGE Standardization
Unique IBGE code identification for all 5,571 Brazilian municipalities, eliminating duplicate city names and integrating seamlessly into ERPs.
Companies that trust FeriadosAPI
From startups to enterprises, over 1,000 clients and developers use our API every day.
What our customers say
Teams that use FeriadosAPI daily to automate deadlines, schedules, and calculations.
“Integrating Feriados API into our virtual wedding planner Sofia's intelligence was essential. Now, she can alert couples about municipal holidays that could increase vendor costs by up to 100% or create logistical issues for guests, ensuring flawless planning.”

Evelyn C. Bini
CEO, Meu Casamento AI
“Calculating DAS tax due dates and invoice expiration dates requires absolute precision regarding holidays and banking business days. With Feriados API, we automated this end-to-end and eliminated 100% of calculation errors caused by municipal and moveable banking holidays.”

João Gandra
Founder, SimplesMEI
Start in minutes
Easy-to-integrate REST API with any programming language
# Fetch all national holidays in 2026
curl -X GET "https://feriadosapi.com/api/v1/feriados/nacionais?ano=2026" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"// Fetch holidays for São Paulo in 2026
fetch('https://feriadosapi.com/api/v1/feriados/estado/SP?ano=2026', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
})
.then(res => res.json())
.then(data => console.log(data));
// Response
{
"feriados": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"data": "2026-01-01",
"nome": "New Year's Day",
"tipo": "NATIONAL"
},
{
"id": "987f6543-a21c-45e6-b789-321098765432",
"data": "2026-07-09",
"nome": "Constitutionalist Revolution",
"tipo": "STATE",
"uf": "SP"
}
]
}import requests
# Fetch national holidays in 2026
response = requests.get(
'https://feriadosapi.com/api/v1/feriados/nacionais',
params={'ano': 2026},
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
feriados = response.json()
print(feriados)<?php
// Fetch holidays by date
$data = '2026-12-25';
$url = "https://feriadosapi.com/api/v1/feriados/data/" . $data;
$options = [
"http" => [
"header" => "Authorization: Bearer YOUR_API_KEY"
]
];
$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);
$resultado = json_decode($response);
if (count($resultado->feriados) > 0) {
echo "Holiday: " . $resultado->feriados[0]->nome;
}
?>How it works
Simple and fast. In 3 steps you're ready to go
Choose your Plan
Select the plan that best fits your request volume needs.
Get your API Key
After signing up, you immediately receive your access key.
Start Integrating
Use our complete documentation and ready-made examples to integrate in minutes.
Plans & Pricing
Choose the ideal plan for your business. No hidden fees.
Free
Free forever for National, State, and Capitals
- National, State, and 27 Capital Holidays Free (Unlimited)
- Interior municipalities (no free quota, paid plans only)
- Rate limit: 60 req/min
- Real-time webhooks
- Availability SLA
- Up to 3 team users
- Community Support
Developer
Personal projects and on-demand queries
- National, State, and 27 Capital Holidays Free (Unlimited)
- 5,000 requests/month (interior cities & all 5,571 municipalities)
- Rate limit: 60 req/min
- Real-time webhooks
- Availability SLA
- Up to 3 team users
- Basic Support (Email)
StarterPopular
Ideal choice for production applications
- National, State, and 27 Capital Holidays Free (Unlimited)
- 100,000 requests/month (interior cities & all 5,571 municipalities)
- Expanded rate limit: 120 req/min
- 3 Real-time webhooks
- 99.5% Availability SLA
- Up to 10 team users
- Priority Support (Email)
Professional
For high-demand and mission-critical scale
- National, State, and 27 Capital Holidays Free (Unlimited)
- Unlimited requests (interior cities & all 5,571 municipalities)
- High-throughput rate limit: 1,000 req/min
- 10 Real-time webhooks
- 99.9% Availability SLA
- Up to 1,000 team users
- Dedicated VIP Support (WhatsApp)
No credit card required. Cancel or upgrade at any time.
Frequently Asked Questions
Clear your doubts about our holiday API
How does the API keep municipal holiday data up-to-date?
Can I test the API before subscribing to a plan?
Does the API include moveable holidays like Carnival and Easter?
How does the request limit work?
Does the API support real-time Webhooks?
Is the API available for other countries?
How does the API help with my company's compliance?
Can I use the API in development environments?
What is the historical and future year coverage available in the API?
How does technical support work?
Do you offer native integration with AI Agents?
Does the API include banking holidays?
What are the fish swimming on the screen?
Ready to simplify
holiday management?
Join hundreds of companies that already trust our API to manage Brazilian holidays automatically and reliably.
No credit card required• Cancel anytime




