Brazilian Holidays API
Query national, state, municipal, and banking holidays across all of Brazil with a single REST API in JSON. Start for free in minutes.
Feriados API is a REST API that returns national, state, municipal, and FEBRABAN banking holidays across all 5,570+ Brazilian municipalities in JSON format, with an AI-ready MCP server.
Explore holiday categories
Each holiday category has a dedicated endpoint. Choose what best fits your integration workflow.
National Holidays
Brazil’s official national holidays, with fixed and mobile dates (like Carnival and Easter) calculated automatically for any year.
State Holidays
Official holidays across all 27 Brazilian states (26 UFs plus the Federal District), queried by 2-letter state abbreviation.
Municipal Holidays
Local holidays for all 5,570+ Brazilian municipalities, queried by the city’s official 7-digit IBGE code.
Banking Holidays
Banking holidays according to the FEBRABAN schedule and verification of banking business days by date.
One request, every holiday
Authentication uses an API key sent in the X-API-Key header or Authorization: Bearer <KEY>. Every response includes the X-Quota-Remaining header indicating your remaining quota.
curl https://feriadosapi.com/api/v1/feriados/nacionais \
-H "X-API-Key: YOUR_KEY"
# Response (JSON)
{
"tipo": "NACIONAL",
"ano": "2026",
"feriados": [
{ "data": "01/01/2026", "nome": "Confraternização Universal", "tipo": "NACIONAL" },
{ "data": "21/04/2026", "nome": "Tiradentes", "tipo": "NACIONAL" }
]
}Main endpoints
GET /api/v1/feriados # list with filters (date, type, UF, IBGE)
GET /api/v1/feriados/nacionais # national holidays (free)
GET /api/v1/feriados/estado/{uf} # state holidays, 27 UFs (free)
GET /api/v1/feriados/cidade/{ibge} # municipal holidays, 5,570 cities (capitals free)
GET /api/v1/feriados/bancarios # FEBRABAN banking holidays (free)
GET /api/v1/feriados/dia-util-bancario/{data} # check banking business day (free)
GET /api/v1/estados # list Brazilian states
GET /api/v1/municipios # list municipalities by UF
GET /api/v1/municipio/{ibge} # get municipality infoOn the free plan, national holidays, state holidays, all 27 state capitals, and location lookup endpoints are freely available (limited to 60 requests per minute and up to 3 users). Non-capital interior municipalities require a paid tier starting with the Developer plan ($15/mo or R$39/mo, 5,000 monthly requests, covering all 5,570+ municipalities).
Frequently Asked Questions
What is the Brazilian Holidays API?
Feriados API is a REST API that returns national, state, municipal, and banking (FEBRABAN) holidays across all 5,570+ Brazilian municipalities in JSON format. It also includes an MCP server for seamless integration with AI agents.
What types of holidays does the API cover?
The API covers national holidays, state holidays across all 27 federative units (26 states plus the Federal District), municipal holidays for all 5,570+ cities, and banking holidays according to the official FEBRABAN calendar.
Is the holidays API free or paid?
The free plan grants access to national holidays, state holidays, all 27 state capitals, and location lookup endpoints, with a rate limit of 60 requests/minute and up to 3 users. Accessing non-capital interior cities requires a paid plan. The Developer plan costs R$39/month with 5,000 monthly requests and full access to all 5,570+ municipalities.
What data format does the API return?
All API responses are formatted in JSON over standard REST HTTPS. Authentication requires an API key passed in the X-API-Key header or via Authorization: Bearer <KEY>, and every response includes the X-Quota-Remaining header.
Does the API work with AI agents and LLMs?
Yes! Besides our standard JSON REST API, we host a dedicated Model Context Protocol (MCP) server at https://mcp.feriadosapi.com allowing AI agents (like Claude or Cursor) to query Brazilian holidays directly.