# Feriados API

> API REST JSON de feriados brasileiros (nacionais, estaduais, municipais e bancários FEBRABAN) cobrindo todos os 5.570 municípios do Brasil. Também oferece servidor MCP (Model Context Protocol) para agentes de IA.

## Documentação

- [Documentação Técnica](https://feriadosapi.com/docs): Referência completa da API com endpoints, autenticação e exemplos de código.
- [OpenAPI Spec](https://feriadosapi.com/openapi.yaml): Especificação OpenAPI/Swagger da API.
- [Calendário de Feriados](https://feriadosapi.com/calendario): Calendário interativo de feriados brasileiros.
- [Feriados Hoje](https://feriadosapi.com/hoje): Consulte feriados no dia de hoje em todo o Brasil.

## API de Feriados

- [API de Feriados](https://feriadosapi.com/api-feriados): Visão geral da API REST de feriados nacionais, estaduais, municipais e bancários.
- [API de Feriados Nacionais](https://feriadosapi.com/api-feriados/nacionais): Endpoint de feriados nacionais em JSON, gratuito em todos os planos.
- [API de Feriados Estaduais](https://feriadosapi.com/api-feriados/estaduais): Feriados por estado (27 UFs), gratuito em todos os planos.
- [API de Feriados Municipais](https://feriadosapi.com/api-feriados/municipais): Feriados dos 5.570 municípios; capitais gratuitas, interior nos planos pagos.
- [API de Feriados Bancários](https://feriadosapi.com/api-feriados/bancarios): Feriados bancários FEBRABAN e verificação de dia útil bancário, gratuito.

Páginas de feriados por estado disponíveis em https://feriadosapi.com/feriados/{estado} (exemplos: /feriados/sao-paulo, /feriados/rio-de-janeiro, /feriados/minas-gerais), uma para cada um dos 27 estados.

## Casos de Uso

- [ERPs e Sistemas Financeiros](https://feriadosapi.com/casos-de-uso/erp): Automatize vencimentos de boletos e cálculos de dias úteis.
- [RH e Gestão de Ponto](https://feriadosapi.com/casos-de-uso/rh): Controle horas extras considerando feriados locais.
- [E-commerce e Logística](https://feriadosapi.com/casos-de-uso/ecommerce): Melhore previsão de entrega com dados de feriados.

## Endpoints da API

- GET /api/v1/feriados: Lista feriados com filtros (data, tipo, UF, IBGE)
- GET /api/v1/feriados/nacionais: Feriados nacionais
- GET /api/v1/feriados/estado/{uf}: Feriados por estado (27 UFs)
- GET /api/v1/feriados/cidade/{ibge}: Feriados por município (5.570 cidades)
- GET /api/v1/feriados/bancarios: Feriados bancários FEBRABAN (gratuito)
- GET /api/v1/feriados/dia-util-bancario/{data}: Verifica se data é dia útil bancário (gratuito)
- GET /api/v1/estados: Lista estados brasileiros
- GET /api/v1/municipios: Lista municípios por UF
- GET /api/v1/municipio/{ibge}: Informações do município

Todos os endpoints retornam o campo "bancario" (booleano) em cada feriado. Adicione ?bancarios=true a qualquer endpoint para filtrar apenas feriados bancários.

## Planos e Preços

Feriados nacionais, estaduais, bancários e das 27 capitais são gratuitos em todos os planos (rate limit de 60 req/min nos planos Free e Developer). Municípios do interior (não-capitais) requerem plano pago.

- Free: Grátis, feriados nacionais + estaduais + 27 capitais + consulta de localidades, rate limit 60 req/min, até 3 usuários
- Developer: R$39/mês, 5.000 req/mês (todos os 5.570 municípios), rate limit 60 req/min, até 3 usuários
- Starter: R$99/mês, 100.000 req/mês (todos os 5.570 municípios), sem rate limit, até 10 usuários
- Professional: R$249/mês, 1.000.000 req/mês (todos os 5.570 municípios), sem rate limit, usuários ilimitados

## Contato

- Email: contato@feriadosapi.com
- Site: https://feriadosapi.com
- MCP Server: https://mcp.feriadosapi.com