Start

API Endpoint

https://rodriguesfas.github.io/holidays
                

A small API of Brazilian holidays provided by GitHub Pages.

You don't need a key to use this API.

Get National Holidays

# Here is a curl example
curl -X GET \ 
    https://rodriguesfas.github.io/holidays/national.json
                

To get national holidays you need to make a GET call to the following url :
https://rodriguesfas.github.io/holidays/national.json

Result example :

[
  {
    "date": "01/01",
    "title": "Confraternização Universal",
    "description": "Início do ano civil, Dia Mundial da Paz, além de Dia da Fraternidade Universal, sendo assim, um feriado internacional, adotado por quase todas as nações do planeta.",
    "legislation": "Lei nº 10.607, de 19 de dezembro de 2002 - http://www.planalto.gov.br/ccivil_03/leis/2002/L10607.htm",
    "type": "feriado",
    "startTime": "",
    "endTime": "",
    "variableDates": {
      
    }
  },
  {
    "date": "",
    "title": "Sexta-Feira da Paixão",
    "description": "Data cristã na qual a morte de Cristo é lembrada.",
    "legislation": "Lei nº 9.093, de 12 de setembro de 1995 - http://www.planalto.gov.br/ccivil_03/Leis/L9093.htm",
    "type": "feriado",
    "startTime": "",
    "endTime": "",
    "variableDates": {
      "2015": "03/04",
      "2016": "25/03",
      "2017": "14/04",
      "2018": "30/03",
      "2019": "19/04",
      "2020": "10/04"
    }
  },
  {
    "date": "21/04",
    "title": "Tiradentes",
    "description": "Homenagem ao mártir da Inconfidência Mineira",
    "legislation": "Lei nº 10.607, de 19 de dezembro de 2002 - http://www.planalto.gov.br/ccivil_03/leis/2002/L10607.htm",
    "type": "feriado",
    "startTime": "",
    "endTime": "",
    "variableDates": {
      
    }
  },
  {
    "date": "01/05",
    "title": "Dia do Trabalhador",
    "description": "Dia Internacional dos Trabalhadores, adotado por muitos países.",
    "type": "feriado",
    "startTime": "",
    "endTime": "",
    "legislation": "Lei nº 10.607, de 19 de dezembro de 2002 - http://www.planalto.gov.br/ccivil_03/leis/2002/L10607.htm",
    "variableDates": {
      
    }
  },
  {
    "date": "07/09",
    "title": "Independência",
    "description": "Data do chamado Grito do Ipiranga, que iniciou o processo de Independência do Brasil.",
    "legislation": "Lei nº 10.607, de 19 de dezembro de 2002 - http://www.planalto.gov.br/ccivil_03/leis/2002/L10607.htm",
    "type": "feriado",
    "startTime": "",
    "endTime": "",
    "variableDates": {
      
    }
  },
  {
    "date": "12/10",
    "title": "Nossa Senhora Aparecida",
    "description": "Padroeira do Brasil",
    "legislation": "Lei nº 6.802, de 30 de junho de 1980 - http://www.planalto.gov.br/ccivil_03/Leis/L6802.htm",
    "type": "feriado",
    "startTime": "",
    "endTime": "",
    "variableDates": {
      
    }
  },
  {
    "date": "02/11",
    "title": "Finados",
    "description": "Dia de memória aos mortos",
    "legislation": "Lei nº 10.607, de 19 de dezembro de 2002 - http://www.planalto.gov.br/ccivil_03/leis/2002/L10607.htm",
    "type": "feriado",
    "startTime": "",
    "endTime": "",
    "variableDates": {
      
    }
  },
  {
    "date": "15/11",
    "title": "Proclamação da República",
    "description": "Derrubada da Monarquia e instalação da República.",
    "legislation": "Lei nº 10.607, de 19 de dezembro de 2002 - http://www.planalto.gov.br/ccivil_03/leis/2002/L10607.htm",
    "type": "feriado",
    "startTime": "",
    "endTime": "",
    "variableDates": {
      
    }
  },
  {
    "date": "25/12",
    "title": "Natal",
    "description": "Celebração cristã do nascimento de Cristo",
    "legislation": "Lei nº 10.607, de 19 de dezembro de 2002 - http://www.planalto.gov.br/ccivil_03/leis/2002/L10607.htm",
    "type": "feriado",
    "startTime": "",
    "endTime": "",
    "variableDates": {
      
    }
  }
]
                

Get State Holidays

# Here is a curl example
curl -X GET \ 
    https://rodriguesfas.github.io/holidays/state/{uf}.json
                

To get national holidays you need to make a GET call to the following url :
https://rodriguesfas.github.io/holidays/state/{uf}.json

Result example :

                

QUERY PARAMETERS

Field	Type	Description
uf	String	UF (Federative Unit) code of the state.

Get City Holidays

# Here is a curl example
curl -X GET \ 
    https://rodriguesfas.github.io/holidays/city/{initial}.json
                

To get national holidays you need to make a GET call to the following url :
https://rodriguesfas.github.io/holidays/city/{initial}.json

Result example :

                

QUERY PARAMETERS

Field	Type	Description
initial	String	Initial code a of the city.

Credits

Baseline Inspiration	https://github.com/dadosbr
API-Documentation-HTML-Template	https://github.com/ticlekiwi/API-Documentation-HTML-Template