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 holidays for all 5,570 Brazilian municipalities, including city-specific holidays.
Always Up-to-Date
Our team constantly updates the database with new decrees and legislative changes.
Compliance & Banking Calendar
Data validated against current legislation and the official FEBRABAN banking calendar. Automatically check business days and calculate due dates.
High Availability
99.9% SLA with redundant infrastructure and 24/7 monitoring.
Historical & Future Data
Query past and future holidays, ideal for planning and historical reporting.
Simple REST API
Easy integration with any programming language. Complete documentation and practical examples.
The difference is in municipal holidays
While national and state holidays are easy to find, municipal holidays are extremely difficult to keep updated
- Manually search municipal decrees
- Maintain spreadsheets for 5,570 municipalities
- Risk of outdated or incorrect data
- Payroll and deadline calculation errors
- Hours of recurring manual work
- One REST call for any municipality
- All 5,570 municipalities always up-to-date
- Data validated against current legislation
- Guaranteed compliance for HR and legal
- Integration in minutes, not weeks
Companies that trust FeriadosAPI
From startups to enterprises, thousands of 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.
Annual plan: pay for 10 months, get 12 (2 months free)
Free
Perfect to get started and test
- Free National & State Holidays
- Free Holidays for 27 State Capitals
- Free Municipality Lookup
- Rate limit: 60 req/min (free routes)
- Up to 3 users
- Community Support
Developer
Personal projects and on-demand queries
- 5,000 requests/month (non-capital municipalities)
- Rate limit: 60 req/min
- Up to 3 users
- Basic Support (Email)
- Free National, State & Capital Holidays
- All 5,570 Municipalities
StarterPopular
For production applications
- 100,000 requests/month (non-capital municipalities)
- No rate limit
- Up to 10 users
- Priority Support (Email)
- Free National, State & Capital Holidays
- All 5,570 Municipalities
- 99.5% Availability SLA
Professional
For high-demand and intensive use
- Unlimited requests (non-capital municipalities)
- No rate limit
- Unlimited users
- Priority Support (WhatsApp)
- Free National, State & Capital Holidays
- All 5,570 Municipalities
- 99.9% SLA
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?
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?
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




