Introdução

O Cálculo Jurídico tem a API de índices econômicos mais completa do Brasil.

A API é simples e segue o padrão REST.

Ela conta com a grande maioria dos índices econômicos e dos tribunais do Brasil. Os índices são curados, validados e atualizados continuamente.

Se você mantém um sistema que precisa realizar atualizações de débitos ou correções monetárias, entre em contato com nosso time para avaliar usar a nossa API como fonte dos seus índices de correção.

Uso básico

A API é fácil de usar e possui 2 endpoints:

  1. /v1/list - Traz a lista de índices disponível com as chaves pra buscar
  2. /v1/index?index_kind=chave_do_indice - Traz os dados do índice em questão

Veja o exemplo: https://indices.calculojuridico.com.br/v1/index?index_kind=ipca.

Uma requisição a esse endpoint retornará um array JSON com todos os valores disponíveis para um determinado índice em 3 formatos:

  1. Variação
  2. Fator de correção
  3. Valor cumulativo
    Para facilitar o cálculo da correção monetária entre duas datas

{
"name": "IPCA - Índice Nacional de Preços ao Consumidor
Amplo",
"key": "ipca",
"last_update": "2023-08-12T11:40:41.210Z",
"indices": [
{
"year": "1980",
"month": "1",
"factor": "1.0662",
"variation_percentage": "6.62",
"cumulative_value": "1.0662"
},
{
"year": "1980",
"month": "2",
"factor": "1.0462",
"variation_percentage": "4.62",
"cumulative_value": "1.11545844"
},
{
"year": "1980",
"month": "3",
"factor": "1.0604",
"variation_percentage": "6.04",
"cumulative_value": "1.1828321298"
},
{
"year": "1980",
"month": "4",
"factor": "1.0529",
"variation_percentage": "5.29",
"cumulative_value": "1.2454039495"
},
{
"year": "1980",
"month": "5",
"factor": "1.057",
"variation_percentage": "5.7",
"cumulative_value": "1.3163919746"
},
{
"year": "1980",
"month": "6",
"factor": "1.0531",
"variation_percentage": "5.31",
"cumulative_value": "1.3862923885"
},
...
]
}

Por padrão, todas as respostas vêm com as informações do nome do índice: month e cumulative_value. Para personalizar o retorno, você pode utilizar os seguintes parâmetros:

const API_URL = "https://indices.calculojuridico.com.br/v1/index?index_kind=ipca";

const request = await axios.get(API_URL, {

headers: {

method: "GET",

"X-CJ-API-KEY": SUA_CHAVE,

"Content-Type": "application/json"

}

});

curl -X GET https://indices.calculojuridico.com.br/v1/index?index_kind=ipca -H "X-CJ-API-KEY: SUA_CHAVE" -H "Content-Type: application/json"

Exemplo de requisição em NodeJS usando axios

Autenticação

Qualquer requisição para a API precisa de uma chave que deve ser incluída na chave "X-CJ-API-KEY" do header da requisição, como também mostrado no exemplo de requisição ao lado.

Fale com o nosso time para conseguir sua chave de acesso à API.
Clique aqui para pedir a sua chave.

Parâmetros

index_kind

Obrigatório.

Esse parâmetro deve ser obrigatoriamente incluso na URL da requisição, pois ele especifica qual índice está sendo buscado. Alguns exemplos de valores que podem ir nesse parâmetro são: ipca, inpc, tr, etc. Você pode conferir nossa lista completa de índices na seção Nossos índices.

const API_URL = "https://indices.calculojuridico.com.br/v1/index?index_kind=ipca";

[

{

"year": 1980,

"month": 01,

"cumulative_value": "..."

},

{

"year": 1980,

"month": 02,

"cumulative_value": "..."

},

{

"year": 1980,

"month": 03,

"cumulative_value": "..."

},

...

]

Exemplo de resposta com apenas o parâmetro index_kind definido

start_date / end_date

Opcionais.

Com esses parâmetros, é possível definir um intervalo de tempo para a requisição dos índices. O valor do parâmetro pode estar nos formatos

  • YYYY/MM/DD
  • YYYY/MM
  • MM/YYYY
  • DD/MM/YYYY

Apesar de aceitar datas com dias, a API apenas considera mês e ano para buscar os índices. Assim, por exemplo, ao adicionar os parâmetros start_date=2010/11&end_date=01/01/2011, a API entregará os índices de 11/2010, 12/2010 e 01/2011.

const API_URL = "https://indices.calculojuridico.com.br/v1?index_kind=ipca&start_date=2010/11&end_date=01/01/2011";

[

{

"year": 2010,

"month": 11,

"cumulative_value": "..."

},

{

"year": 2010,

"month": 12,

"cumulative_value": "..."

},

{

"year": 2011,

"month": 01,

"cumulative_value": "..."

}

]

</p>

Exemplo de resposta com os parâmetros start_date e end_date definidos


Quais são os índices de correção monetária disponíveis na API?

O CJ tem o maior acervo curado e validado de tabelas de índices de correção monetária e juros.

São índices Judiciais, do Mercado Financeiro, Taxas e Multas, Preços e Custos, Previdenciários e Outros.

Alguns dos índices dentro dessas categorias, que disponibilizamos via API:

  • IGP-DI - Índice Geral de Preços - Disponibilidade Interna
  • IGP-M - Índice Geral de Preços do Mercado
  • IGP10 - Índice Geral de Preços 10
  • INCC - Índice Nacional de Custos da Construção
  • INCC-M - Índice Nacional de Custo da Construção - Mercado
  • INPC - Índice Nacional de Preços ao Consumidor
  • IPC - Índice de preços ao consumidor (Em suas várias apresentações)
  • IPCA - Índice Nacional de Preços ao Consumidor Amplo
  • IPCA-15 - Índice de Preços ao Consumidor Amplo
  • IPCA-E - Índice Nacional de Preços ao Consumidor Amplo Especial
  • IST - Índice de Serviços de Telecomunicações
  • Índices JAM (Juros e atualização monetária)
  • Índice do Manual de Cálculos
  • Poupança
  • SELIC (Meta e Over)
  • TBF - Taxa básica financeira
  • TR - Taxa Referencial
  • CDI - Certificado de Depósito Interbancário
  • ENCOGE - Justiça Estadual
  • Índice de correção dos salários de contribuição (com ou sem enunciado 75-TRF3, com ou sem ORTN de 84/88)
  • TJLP mensal
  • Indices compostos como "IGPDI até 01/2004, INPC até 06/2009, TR depois"
  • Índices de tribunais:
    • TJSP - Tribunal de Justiça de SP
    • TJRJ - Tribunal de Justiça do RJ
    • TJMG - Tribunal de Justiça de Minas Gerais com ou sem expurgos
    • TJPR - 3 índices diferentes
    • TJRS - Tribunal de Justiça do Rio Grande do Sul
    • TJSC - Tribunal de Justiça de SC
    • TJES - Tribunal de Justiça do ES

E índices de todos os demais tribunais do Brasil!

E muitos outros índices... Consulte com o nosso atendimento.