canonical: https://jentic.com/apis/feriadosapi.com/feriadosapi # Feriados API The Feriados API returns Brazilian public holidays and banking-calendar data for scheduling and date calculations. It lists national, state, and municipal holidays by year, checks whether a given date is a holiday, and returns the FEBRABAN bank-holiday calendar along with a check for whether a date is a banking business day. It also serves reference lists of every Brazilian state and all 5,571 municipalities with their IBGE codes, so a lookup can resolve a city before asking for its holidays. ## For AI agents Look up Brazilian national, state, and municipal public holidays, check whether a date is a holiday or a banking business day, and resolve states and municipalities by IBGE code. ## Scope Does not handle event booking, reminders, or holidays outside Brazil. Use for Brazilian holiday and banking-calendar lookups only. ## Capabilities - List Brazilian national public holidays for a given year, optionally including facultative days - Check whether a specific date is a holiday and return the matching holidays - Get state-level or municipal holidays by UF or IBGE city code - List the FEBRABAN bank-holiday calendar and check whether a date is a banking business day - List all Brazilian states and the 5,571 municipalities with their IBGE codes ## Use cases ### Agent scheduling around Brazilian holidays through Jentic An AI scheduling assistant needs to avoid booking work or deliveries on a Brazilian holiday. It checks a candidate date, and if the date is a holiday the response names it, so the agent can move the booking to the next working day. State and municipal lookups let the agent respect a local holiday that a national calendar would miss. Example prompt: Check whether 2026-12-25 is a holiday for the state of SP and report the holiday name if it is one ### Banking settlement date calculation Payment and settlement flows must land on a banking business day. The API serves the FEBRABAN bank-holiday calendar and a direct check that returns whether a date is a banking business day, and when it is not, the reason and the next business day, so a finance workflow can schedule a payout correctly. Example prompt: Check whether 2026-02-16 is a banking business day and return the next business day when it is not ### Municipality-aware holiday lookup Holidays in Brazil vary by state and city, so an app serving many locations needs the right local calendar. The API resolves a municipality by its IBGE code and returns that city's full holiday list, letting a workforce or logistics tool apply the correct days off for each location it operates in. Example prompt: Resolve the municipality with IBGE code 3550308 and list its holidays for 2026 ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/feriados/nacionais` | List national holidays for a year | | GET | `/feriados/data/{data}` | Check whether a date is a holiday | | GET | `/feriados/estado/{uf}` | Holidays for a state | | GET | `/feriados/cidade/{ibge}` | Holidays for a city by IBGE code | | GET | `/feriados/bancarios` | List FEBRABAN bank holidays | | GET | `/feriados/dia-util-bancario/{data}` | Check whether a date is a banking business day | | GET | `/estados` | List Brazilian states | | GET | `/municipios` | List municipalities | ## Key resources - **Holidays** — National, state, and municipal holidays by year, plus a date-is-holiday check - **Bank calendar** — The FEBRABAN bank-holiday list and a banking-business-day check - **Localities** — Reference lists of states and the 5,571 municipalities with IBGE codes ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 42 / 100 - **Maturity:** Foundational - **Dimensions:** - Foundational Compliance: 100 / 100 - Developer Experience & Jentic Compatibility: 62 / 100 - AI-Readiness & Agent Experience: 18 / 100 - Agent Usability: 94 / 100 - Security: 55 / 100 - AI Discoverability: 74 / 100 - **View full report:** https://jentic.com/apis/feriadosapi.com/feriadosapi/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the Feriados API by hand means choosing between the X-API-Key header and a Bearer token, tracking which lookups consume quota, and paginating the municipality lists yourself. Through Jentic you install once, import it from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** Every Feriados operation is a read, so a rule can allow just the holiday and locality lookups your agent needs. You choose which it may call, for example the national and bank-holiday reads without the full municipality dump. - **Credential handling:** Your Feriados API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'check if a date is a holiday in Brazil' or 'list bank holidays', and Jentic returns the matching Feriados operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Abstract API** — Abstract's API suite includes a public-holidays lookup spanning many countries, while Feriados is Brazil-specific with bank-calendar detail. - **Google Calendar** — Google Calendar schedules events that a Brazilian holiday check can keep off non-working days. - **Acuity Scheduling** — Acuity books appointments that should skip Brazilian holidays and non-banking days. ## FAQ ### What authentication does the Feriados API use? It accepts an API key sent as the X-API-Key header or as a Bearer token in the Authorization header, per its OpenAPI spec. Every request carries one of those credentials, including the holiday and locality reads. ### Can I check whether a specific date is a holiday with the Feriados API? Yes. Pass the date to the date-lookup endpoint and the response lists any holidays that fall on it, with the holiday name, type, and scope. For banking workflows there is a separate check that tells you whether a date is a banking business day and, if not, the reason and the next business day. ### What are the rate limits for the Feriados API? The OpenAPI spec does not state a request rate limit, though some lookups consume account quota while national and bank-holiday lists are free. Check the Feriados API documentation for the current quota and rate limits before running large batches. ### Is there a Feriados MCP server? You don't need an MCP server to give your agent the Feriados API. Jentic connects it directly from the API Directory: import it, store your credential once, and your agent calls its holiday, bank-calendar, and locality lookups on demand. ### Can I limit what my agent is allowed to do with the Feriados API? Yes. Every operation is a read, so write a rule that allows just the lookups your agent needs, for example the national and bank-holiday reads and the date check, and leave the full municipality list out if it is not needed. Every call it makes is recorded in your Jentic One audit log. ### How do I check Brazilian holidays with the Feriados API through Jentic? Search Jentic for 'check if a date is a holiday in Brazil', add the Feriados API from the directory, and store your API key once; your agent then calls the date check or the yearly national and state lists as it needs them. To run it on your own infrastructure, install Jentic One from its GitHub repo.