FeriadosAPI
Sign In

Brazilian Municipal Holidays API

Query local holidays for any of Brazil’s 5,571 municipalities in JSON format using the city’s official 7-digit IBGE code.

The municipal holidays API covers 100% of Brazil’s 5,571 municipalities via official 7-digit IBGE code lookups. All 27 state capitals are free across all plans. Accessing non-capital interior municipalities requires a paid plan starting with the Developer tier.

How to use

Pass the municipality’s 7-digit IBGE code in the endpoint. The API returns a JSON array of all holidays valid in that city, including local municipal holidays.

# Query holidays for São Paulo city (IBGE: 3550308)
curl https://feriadosapi.com/api/v1/feriados/cidade/3550308?ano=2026 \
  -H "X-API-Key: YOUR_KEY"

# Response
[
  { "nome": "Aniversário de São Paulo", "data": "25/01/2026", "tipo": "MUNICIPAL", "ibge": "3550308" },
  { "nome": "Consciência Negra", "data": "20/11/2026", "tipo": "MUNICIPAL", "ibge": "3550308" }
]

Authentication via X-API-Key header or Authorization: Bearer YOUR_KEY. Your remaining quota is returned in the X-Quota-Remaining header.

Coverage and benefits

100% coverage of all 5,571 Brazilian municipalities without exception.
All 27 state capitals are completely free on the Free tier.
Standardized lookup using official 7-digit IBGE codes, compatible with government ERP systems.
Returns consolidated national, state, and municipal holidays for the exact location.
Full access to interior municipalities on paid plans (Developer at R$39/mo).
Essential for accurate shipping estimates, payroll overtime, and local billing due dates.

Frequently Asked Questions

How many municipalities does the municipal holidays API cover?

The API covers all 5,571 Brazilian municipalities. Lookups are performed using the city’s official 7-digit IBGE code.

Are state capitals free to query?

Yes! Querying municipal holidays for any of the 27 Brazilian state capitals is 100% free across all plans and consumes zero quota.

What about interior (non-capital) municipalities?

Querying interior cities requires a paid plan starting at the Developer tier (R$39/month for 5,000 monthly requests).

What is an IBGE code?

The IBGE code is a unique 7-digit identifier assigned by the Brazilian Institute of Geography and Statistics (IBGE) to every municipality in Brazil. For example: 3550308 for São Paulo, 3304557 for Rio de Janeiro.

How can I find a city’s IBGE code?

You can use our endpoint GET /api/v1/municipios?uf=SP to list all municipalities and their IBGE codes for any state, or reference public IBGE census tables.

Related resources

Holidays API

General overview and complete endpoint documentation.

National Holidays

Official national holidays across Brazil.

State Holidays

Query by UF across all 27 Brazilian states and DF.

Documentation

Complete integration and authentication guide.

Holiday Calendar

Browse the complete holiday calendar for the year.

Ready to integrate?

Create Free Account