Quickstart

Holibras is a read-mostly API for Brazilian holidays — national, state, and municipal (all 5,570 IBGE codes). Get a token, send a request, ship the integration in under five minutes.

1. Create an account

Register at holibras.com.br/auth/register. After verifying your email, you land on the client panel. There's no monthly cap — only a rate limit of 20 req/s per token.

2. Issue a token

From tokens → new, give it a label, pick an environment (test or live), and optionally restrict it to specific domains or IPs.

3. Make your first request

curl https://api.prod.holibras.com.br/v1/holidays?year=2026&uf=SP \
  -H 'Authorization: Bearer fk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

4. Parse the response

{
  "data": [
    {
      "date": "2026-01-01",
      "name": "Confraternização Universal",
      "scope": "NATIONAL",
      "type": "FIXED"
    },
    {
      "date": "2026-01-25",
      "name": "Aniversário de São Paulo",
      "scope": "MUNICIPAL",
      "type": "FIXED"
    }
  ]
}

That's it. Read the holidays reference for filters (scope, ibge, date ranges) or jump to the playground to try it interactively.