Consultar Taxa de Juros Atual

Este endpoint permite consultar a taxa de juros atual passando como parametro a data e o segmento desejados.

Segurança

Para acessar a API, é necessário obter um token de acesso através do fluxo de autenticação OAuth2. Veja mais detalhes em Como obter acesso?

info

Ao gerar o token JWT, não esqueça de utilizar o escopo correto. Caso contrário, a requisição será rejeitada com o código de erro 401 Unauthorized.

Requisição

GET https://api-sandbox.catalisa.com.br/financial-products/api/v1/financing-tables/current-rates/{segmentId}?filter[currentDate]={currentDate} JWT scope: financing-tables/read:financing-tables

Parâmetros

Nome	Tipo	Descrição
segmentId	string	Identificador único ddo segmento, no formato UUID.
currentDate	string	Data de consulta da vigência, no formato YYYY-MM-DD.

Cabeçalhos

Nome	Valor
Authorization	Bearer <token>
Content-Type	application/json

Exemplo de Requisição

Respostas

Código	Descrição
200	Taxa de juros atualizada com sucesso. Retorna os dados da taxa de juros atualizada
401	Não autorizado

Exemplo de uso

Javascript

const headers = new Headers();
headers.append("Authorization", "Bearer <token>");
headers.append("Content-Type", "application/json");


const requestOptions = {
  method: "GET",
  headers: headers,
};

const response = await fetch(
  "https://api-sandbox.catalisa.com.br/financial-products/api/v1/financing-tables/current-rates/2b61951c-28bc-474a-81a9-4c53cfc8ba05?filter[currentDate]=2024-01-05",
  requestOptions
);
const data = await response.json();
console.log(data);

CURL

curl --location --request GET 'https://api-sandbox.catalisa.com.br/financial-products/api/v1/financing-tables/current-rates/2b61951c-28bc-474a-81a9-4c53cfc8ba05?filter[currentDate]=2024-01-05' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <token>'

Exemplo de Sucesso

{
    "data": [
        {
            "type": "current-rates",
            "id": "3e1f2c17-576f-4203-b2b3-4940868f946b",
            "attributes": {
                "description": "Tabela de financiamento - Empréstimo Atualizada",
                "rates": [
                    {
                        "installments": 12,
                        "rate": 0.046
                    }
                ],
                "maxGracePeriod": 60,
                "minGracePeriod": 20
            }
        }
    ],
    "links": {
        "self": "https://api-sandbox.catalisa.com.br/financial-products/api/v1/financing-tables/current-rates/2b61951c-28bc-474a-81a9-4c53cfc8ba05"
    }
}