Brazilian National Holidays API

Query Brazil’s official national holidays in JSON, including name, date, and category. Free on all plans and ready to integrate in minutes.

The national holidays API returns, in JSON format, all official holidays valid across the entire Brazilian territory, each with its name, date (DD/MM/YYYY), and category. This endpoint is free on all Feriados API plans, including the Free tier, and does not consume monthly request quotas.

How to use

Make a GET request to the national holidays endpoint with your API key. The response is clean JSON, ready for immediate integration.

# List national holidays (free)
curl https://feriadosapi.com/api/v1/feriados/nacionais?ano=2026 \
  -H "X-API-Key: YOUR_KEY"

# Response
{
  "tipo": "NACIONAL",
  "ano": "2026",
  "feriados": [
    { "nome": "Confraternização Universal", "data": "01/01/2026", "tipo": "NACIONAL" },
    { "nome": "Tiradentes", "data": "21/04/2026", "tipo": "NACIONAL" },
    { "nome": "Dia do Trabalho", "data": "01/05/2026", "tipo": "NACIONAL" },
    { "nome": "Independência do Brasil", "data": "07/09/2026", "tipo": "NACIONAL" },
    { "nome": "Nossa Senhora Aparecida", "data": "12/10/2026", "tipo": "NACIONAL" },
    { "nome": "Finados", "data": "02/11/2026", "tipo": "NACIONAL" },
    { "nome": "Proclamação da República", "data": "15/11/2026", "tipo": "NACIONAL" },
    { "nome": "Natal", "data": "25/12/2026", "tipo": "NACIONAL" }
  ]
}

Authentication via X-API-Key header or Authorization: Bearer YOUR_KEY. Every response includes the X-Quota-Remaining header.

Coverage and benefits

National holidays endpoint is 100% free across all plans, zero quota consumption.

Structured JSON responses with name, formatted date, and holiday type.

Query by year, returning official dates valid across the entire country.

Comprehensive ecosystem: national, state (27 UFs), municipal (5,570+ cities), and FEBRABAN banking schedules.

REST JSON API and AI-ready MCP server at mcp.feriadosapi.com.

Free plan includes a rate limit of 60 requests/minute and up to 3 team members.

Frequently Asked Questions

Is the national holidays API free?

Yes! The national holidays endpoint is completely free on all plans, including the Free plan, and does not consume your monthly request quota.

What data is returned for each national holiday?

Each holiday is returned as a JSON object containing its name, date in DD/MM/YYYY format, and type. National holidays apply legally across all of Brazil.

How do I authenticate with the API?

Pass your API key in the X-API-Key header or via Authorization: Bearer YOUR_KEY. Every response includes the X-Quota-Remaining header showing remaining quota.

Can I query national holidays for any year?

Yes. You can filter by year parameter (?ano=YYYY) to query Brazil’s official national holidays for past, current, or future years.

Can I also query state and municipal holidays?

Yes. In addition to national holidays, Feriados API covers state holidays across all 27 UFs and municipal holidays across all 5,570+ Brazilian cities, as well as FEBRABAN banking schedules.

Related resources

Holidays API

General overview and complete endpoint documentation.

State Holidays

Query by UF across all 27 Brazilian states and DF.

Municipal Holidays

Lookup across all 5,570+ cities via 7-digit IBGE code.

Documentation

Complete integration and authentication guide.

Holiday Calendar

Browse the complete holiday calendar for the year.

Ready to integrate?

Create Free Account