Brazil's 1st Holiday MCP Server • Connect your AI Agents

Brazilian HolidaysREST JSON API

Integrate national, state, and municipal holidays in minutes using REST. We also offer native Model Context Protocol (MCP) support to connect your AI Agents. Ideal for ERPs, HR, and E-commerce across 5,571 municipalities.

★★★★★Trusted by 1,000+ developers and companies across Brazil
5,571
Municipalities (100% BR)
+13k
Holidays / Year
2010-2100
History & Future
99.9%
SLA Uptime

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

Without FeriadosAPI
  • 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
With FeriadosAPI
  • 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.

  • Logotipo iFood
  • Logotipo 99
  • Logotipo O Boticário
  • Logotipo Petz
  • Logotipo Moura
  • Logotipo Buser
  • Logotipo AiQFome
  • Logotipo ThoughtWorks
  • Logotipo Flash
  • Logotipo Recrut.ai
  • Logotipo Cobli
  • Logotipo FinanZero
  • Logotipo Botmaker
  • Logotipo Intelipost
  • Logotipo Helppi

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

    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

    João Gandra

    Founder, SimplesMEI

Simple Integration

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;
}
?>
JSON
Response format
REST
Standard architecture
HTTPS
Guaranteed security

How it works

Simple and fast. In 3 steps you're ready to go

1

Choose your Plan

Select the plan that best fits your request volume needs.

2

Get your API Key

After signing up, you immediately receive your access key.

3

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

$ 0/mo/yr
  • 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

$ 9$ 90/mo/yr
Or $7.50 /mo
  • 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

$ 19$ 190/mo/yr
Or $15.83 /mo
  • 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

$ 49$ 490/mo/yr
Or $40.83 /mo
  • 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)
Start Testing for Free — Sign Up

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?
Our team constantly monitors official gazettes and city hall websites across Brazil. We also have partnerships with public agencies and a notification system to capture changes in real time.
Can I test the API before subscribing to a plan?
Yes! We offer a permanent Free plan with no credit card required. You get free and unlimited access forever to National, State, and 27 Capital holidays, plus municipality lookup, with a rate limit of 60 requests per minute and support for up to 3 users. Interior municipalities are exclusive to paid plans.
Does the API include moveable holidays like Carnival and Easter?
Yes! Our API automatically calculates all moveable holidays, including Carnival, Easter, Corpus Christi, and others, considering the specific rules of each municipality.
How does the request limit work?
On the Free plan, access to National, State, and 27 Capital holidays is 100% free and unlimited forever (no monthly quota), with a rate limit of 60 requests per minute — interior municipalities have no free quota and require a paid plan. On paid plans (Developer, Starter, and Professional), national, state, and capital queries remain free and quota-exempt, while monthly quotas (5,000 on Developer, 100,000 on Starter, and unlimited on Professional) are used exclusively for interior municipalities and date queries.
Does the API support real-time Webhooks?
Yes! On the Starter and Professional plans, you can register Webhooks (up to 3 endpoints on Starter and up to 10 on Professional) to receive automatic HTTP POST notifications whenever holidays are created, updated, or decreed. Deliveries include HMAC-SHA256 cryptographic signatures (X-Webhook-Signature), automatic retries with exponential backoff, and full telemetry in the dashboard.
Is the API available for other countries?
Currently, we focus exclusively on Brazil to ensure maximum data quality and accuracy. We cover all Brazilian municipalities with constant updates.
How does the API help with my company's compliance?
Our API ensures your system uses accurate and up-to-date holiday data, essential for correct payroll calculations, overtime, banking deadlines, and legal deadlines. Avoid labor fines and contract errors.
Can I use the API in development environments?
Yes! You can use your API key in both production and development. We recommend creating a separate key for each environment for better control.
What is the historical and future year coverage available in the API?
Feriados API provides 90+ years of continuous coverage: full retroactive history since 2010 and future projections through 2100, with automated calculations of movable holidays (Carnival, Easter, Corpus Christi) and optional days across the entire range.
How does technical support work?
We offer Community support on the Free plan, and email support on paid plans (Developer and Starter). On Starter and Professional plans, support is prioritized, and Professional customers also have direct WhatsApp support.
Do you offer native integration with AI Agents?
Yes! We have Brazil's First Model Context Protocol (MCP) Server for Holidays. This means you can easily configure our APIs in applications built on platforms like OpenAI, Gemini, Claude, Manus, and others. For more details, visit mcp.feriadosapi.com
Does the API include banking holidays?
Yes! We have a complete banking calendar based on CMN Resolution 4,880/2020 and the official FEBRABAN calendar. All holidays include a "bancario" field in the response, and we have dedicated endpoints: /api/v1/feriados/bancarios to list all banking holidays, and /api/v1/feriados/dia-util-bancario/{date} to check if a date is a banking business day and calculate the next business day.
What are the fish swimming on the screen?
Each fish represents a real holiday happening today in Brazil! Larger fish are national holidays, medium ones are state holidays, small ones are municipal, golden stars are commemorative dates, and jellyfish are optional holidays. Hover over any of them to discover which holiday it represents. The data is fetched in real time from our own API — it's a functional Easter Egg that showcases the richness of our database.

Still have questions?

Our team is ready to help you

Contact Us
Get started today

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