Feriados API

Feriados API

A API mais completa de feriados brasileiros cobrindo todos os 5.571 municípios, feriados bancários FEBRABAN e notificações via Webhooks em tempo real com…

Productivity & workspace#calendar

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

A API mais completa de feriados brasileiros cobrindo todos os 5.571 municípios, feriados bancários FEBRABAN e notificações via Webhooks em tempo real com assinatura HMAC-SHA256 (X-Feriados-Signature).

Todas as requisições requerem uma API key válida passada via header Authorization: Bearer ou X-API-Key: .

Endpoints 9

Feriados

  • GETListar Feriados Nacionais/feriados/nacionaisRetorna todos os feriados nacionais de um determinado ano. Este endpoint é gratuito e não consome cota.
  • GETBuscar Feriados por Data/feriados/data/:dataVerifica se uma data específica é feriado. Consome 1 unidade de cota.
  • GETFeriados por Estado/feriados/estado/:ufRetorna feriados estaduais e nacionais de uma UF específica. Gratuito para feriados estaduais padrão.
  • GETFeriados por Cidade (IBGE)/feriados/cidade/:ibgeRetorna todos os feriados de uma cidade pelo código IBGE. Gratuito para capitais; consome cota para outros municípios.

Feriados Bancários

  • GETListar Feriados Bancários/feriados/bancariosRetorna todos os feriados bancários (calendário FEBRABAN) para um determinado ano. Este endpoint é gratuito e não consome cota.
  • GETVerificar Dia Útil Bancário/feriados/dia-util-bancario/:dataVerifica se uma data é dia útil bancário. Se não for, retorna o motivo e o próximo dia útil. Este endpoint é gratuito e não consome cota.

Localidades

  • GETListar Estados/estadosRetorna a lista de todas as Unidades Federativas (UFs). Endpoint gratuito.
  • GETListar Municípios/municipiosRetorna a lista completa de todos os 5.571 municípios brasileiros. Endpoint gratuito.
  • GETBuscar Município por IBGE/municipio/:ibgeRetorna os dados de um município específico. Endpoint gratuito.

API details

Base URL
https://feriadosapi.com/api/v1
Authentication
An API key in the X-API-Key header
A bearer token in the Authorization header
Operations
9 operations on 9 pathsGET 9
Main resources
Feriados 4Localidades 3Feriados Bancários 2
Response formats
application/json
Description format
OpenAPI 3.0.3, API version 1.0.0

How to test the Feriados API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Feriados API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses an API key in the X-API-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Listar Feriados Nacionais” (GET /feriados/nacionais), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Feriados API?

A API mais completa de feriados brasileiros cobrindo todos os 5.571 municípios, feriados bancários FEBRABAN e notificações via Webhooks em tempo real com… It is listed under Productivity & workspace and has 9 endpoints.

Who publishes the Feriados API?

It is listed from Feriados API's public API description (an OpenAPI document), not published by Feriados API on Swastik Codes. Anyone who controls feriadosapi.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Feriados API?

Requests go to https://feriadosapi.com/api/v1. Endpoint paths are added to this base URL.

How do I authenticate with the Feriados API?

It accepts 2 methods: an API key in the X-API-Key header; A bearer token in the Authorization header.

How many endpoints does the Feriados API have?

9 operations on 9 paths (9 GET). The largest groups are Feriados, Localidades, Feriados Bancários.

Is forking the Feriados API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.