# Feriados Nacionais

> Retorna a lista completa de feriados nacionais para o ano especificado. Calcula automaticamente os feriados móveis baseados na data da Páscoa e inclui todos os feriados fixos estabelecidos pela legislação brasileira.

- **Consulta:** `feriados`
- **Categoria:** Internacional
- **Preço:** R$ 0,01 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/feriados`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/internacional/feriados

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/feriados?ano=2026"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/feriados",
    params={"ano": "2026"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/feriados");

url.search = new URLSearchParams({
  "ano": "2026"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `ano` | texto | sim | Ano de referência no formato AAAA (ex.: 2026) | `2026` |

## Resposta

### Exemplo de resposta

```json
[
  {
    "date": "string",
    "name": "string",
    "type": "string",
    "weekday": "string"
  }
]
```

---

Página em HTML: https://fontedata.com/docs/internacional/feriados
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp