FeriadosAPI
Sign In

FEBRABAN Banking Holidays API

Query FEBRABAN banking holidays in JSON and verify valid banking business days for billing settlements and due dates. Free across all plans.

The banking holidays API follows the official FEBRABAN (Brazilian Federation of Banks) schedule and allows real-time verification of whether a specific date is a valid banking business day. Both banking endpoints are free across all plans.

How to use

Query the annual schedule of banking holidays or check whether a specific date (YYYY-MM-DD) is a valid business day for bank transfers and settlements.

# Check if date is a banking business day (Carnival Monday)
curl https://feriadosapi.com/api/v1/feriados/dia-util-bancario/2026-02-16 \
  -H "X-API-Key: YOUR_KEY"

# Response
{
  "data": "2026-02-16",
  "dia_util_bancario": false,
  "motivo": "Carnaval (Segunda-feira)",
  "proximo_dia_util": "2026-02-18"
}

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

Coverage and benefits

Banking endpoints are 100% free across all plans, zero quota consumption.
Calendar strictly aligned with official FEBRABAN operational guidelines.
Point-in-time banking business day check returning specific closure reasons.
Returns the next valid banking business day for automatic due-date postponement.
Critical for ERPs, invoicing systems, bank boletos, and payroll settlement.
Ultra-fast JSON REST API with native support for AI LLM MCP servers.

Frequently Asked Questions

Is the banking holidays API free?

Yes! Both FEBRABAN banking holiday schedules and banking business day verification endpoints are completely free across all plans, including the Free tier.

How do I verify if a date is a banking business day?

Make a GET request to /api/v1/feriados/dia-util-bancario/{date}, passing the date in YYYY-MM-DD format. The JSON response indicates if it is a banking business day and explains why if closed.

What are FEBRABAN banking holidays?

These are days when Brazilian banking institutions are closed for customer operations according to FEBRABAN rules, such as Carnival Monday/Tuesday and New Year’s Eve. Our API lists these dates and calculates valid settlement days.

Why is the banking holidays API important for developers?

It enables automated billing software, ERPs, and fintech platforms to accurately calculate due dates and receivables anticipation without scheduling transfers on banking closures.

How do I authenticate with banking endpoints?

Provide your API key in the X-API-Key or Authorization header. While banking queries are free and consume no quota, valid API key authentication is required.

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