Brazilian State Holidays API by UF
Query state holidays across all 27 Brazilian federative units in JSON. Free across all plans, queried by 2-letter state abbreviation.
The state holidays API returns official holidays for any of the 27 Brazilian federative units (26 states plus the Federal District) in JSON format using the state’s 2-letter UF code. This endpoint is free across all Feriados API plans and does not consume monthly quota.
How to use
Make a GET request passing the desired state abbreviation (e.g., SP, RJ, MG). The API returns a JSON array of state holidays for that jurisdiction.
# List state holidays for São Paulo (SP)
curl https://feriadosapi.com/api/v1/feriados/estado/SP?ano=2026 \
-H "X-API-Key: YOUR_KEY"
# Response
[
{ "nome": "Revolução Constitucionalista", "data": "09/07/2026", "tipo": "ESTADUAL", "uf": "SP" }
]Authentication via X-API-Key header or Authorization: Bearer YOUR_KEY. Every response includes the X-Quota-Remaining header.
Coverage and benefits
Frequently Asked Questions
Is the state holidays API free?
Yes! The state holidays endpoint by UF is completely free on all plans, including the Free plan, and does not consume monthly quota.
How many states does the API cover?
The API covers all 27 Brazilian federative units: the 26 states plus the Federal District (DF). Simply pass the 2-letter state code in the URL.
How do I query holidays for a specific state?
Make a GET request to /api/v1/feriados/estado/{uf}, replacing {uf} with the state code (e.g., SP, RJ, BA). You can also append ?ano=YYYY to filter by year.
What is the difference between state and municipal holidays?
A state holiday is enacted by state legislation and applies to every municipality within that state (such as Constitutional Revolution Day in SP). A municipal holiday applies only to a specific city.
How does authentication work for state holidays?
Provide your API key in the X-API-Key or Authorization header. While calling state endpoints is free and consumes no quota, valid authentication is still required.
Related resources
General overview and complete endpoint documentation.
National HolidaysOfficial national holidays across Brazil.
Municipal HolidaysLookup across all 5,570+ cities via 7-digit IBGE code.
DocumentationComplete integration and authentication guide.
Holiday CalendarBrowse the complete holiday calendar for the year.