Calcula a progressão de regime

curl --request POST \
  --url https://api.jusfy.dev/calculators/api/calculadoras/progressao-regime \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "Progressão de regime - exemplo",
  "convict_info": {
    "customer": {
      "id": 1,
      "name": "Fulano de Tal",
      "document": null
    },
    "number_lawsuit": "0001234-56.2024.8.26.0100"
  },
  "redemptions": [],
  "detractions": [],
  "serious_fault": [],
  "suspensions": [],
  "type_initial_regime": "FECHADO",
  "calculation_strategy": "DEFAULT",
  "condemnations": [
    {
      "criminal_sentences": [
        {
          "type_description": "Roubo (art. 157, CP)",
          "crime_date": "2021-01-10",
          "nature_crime_id": 1,
          "condition_convict_id": 1,
          "penalty_time": {
            "years": 5,
            "months": 0,
            "days": 0
          }
        }
      ],
      "start_date": "2021-01-10",
      "is_considered_serious_fault": false
    }
  ]
}
'

import requests

url = "https://api.jusfy.dev/calculators/api/calculadoras/progressao-regime"

payload = {
    "name": "Progressão de regime - exemplo",
    "convict_info": {
        "customer": {
            "id": 1,
            "name": "Fulano de Tal",
            "document": None
        },
        "number_lawsuit": "0001234-56.2024.8.26.0100"
    },
    "redemptions": [],
    "detractions": [],
    "serious_fault": [],
    "suspensions": [],
    "type_initial_regime": "FECHADO",
    "calculation_strategy": "DEFAULT",
    "condemnations": [
        {
            "criminal_sentences": [
                {
                    "type_description": "Roubo (art. 157, CP)",
                    "crime_date": "2021-01-10",
                    "nature_crime_id": 1,
                    "condition_convict_id": 1,
                    "penalty_time": {
                        "years": 5,
                        "months": 0,
                        "days": 0
                    }
                }
            ],
            "start_date": "2021-01-10",
            "is_considered_serious_fault": False
        }
    ]
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Progressão de regime - exemplo',
    convict_info: {
      customer: {id: 1, name: 'Fulano de Tal', document: null},
      number_lawsuit: '0001234-56.2024.8.26.0100'
    },
    redemptions: [],
    detractions: [],
    serious_fault: [],
    suspensions: [],
    type_initial_regime: 'FECHADO',
    calculation_strategy: 'DEFAULT',
    condemnations: [
      {
        criminal_sentences: [
          {
            type_description: 'Roubo (art. 157, CP)',
            crime_date: '2021-01-10',
            nature_crime_id: 1,
            condition_convict_id: 1,
            penalty_time: {years: 5, months: 0, days: 0}
          }
        ],
        start_date: '2021-01-10',
        is_considered_serious_fault: false
      }
    ]
  })
};

fetch('https://api.jusfy.dev/calculators/api/calculadoras/progressao-regime', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.jusfy.dev/calculators/api/calculadoras/progressao-regime",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Progressão de regime - exemplo',
    'convict_info' => [
        'customer' => [
                'id' => 1,
                'name' => 'Fulano de Tal',
                'document' => null
        ],
        'number_lawsuit' => '0001234-56.2024.8.26.0100'
    ],
    'redemptions' => [
        
    ],
    'detractions' => [
        
    ],
    'serious_fault' => [
        
    ],
    'suspensions' => [
        
    ],
    'type_initial_regime' => 'FECHADO',
    'calculation_strategy' => 'DEFAULT',
    'condemnations' => [
        [
                'criminal_sentences' => [
                                [
                                                                'type_description' => 'Roubo (art. 157, CP)',
                                                                'crime_date' => '2021-01-10',
                                                                'nature_crime_id' => 1,
                                                                'condition_convict_id' => 1,
                                                                'penalty_time' => [
                                                                                                                                'years' => 5,
                                                                                                                                'months' => 0,
                                                                                                                                'days' => 0
                                                                ]
                                ]
                ],
                'start_date' => '2021-01-10',
                'is_considered_serious_fault' => false
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "statusCode": 200,
  "message": "Cálculo concluído com sucesso",
  "timestamp": "2026-06-22T18:00:00.000Z",
  "path": "/api/calculadoras/progressao-regime",
  "result": {
    "detraction_days": 0,
    "redemption_days": 0,
    "suspensions_days": 0,
    "total_sentence_days": 1825,
    "reports": {
      "summary": null,
      "complete": null,
      "expert": null
    },
    "progressions": [
      {
        "date_to_progression": "2022-04-11T00:00:00.000Z",
        "progression_title": "Progressão para o regime semiaberto"
      }
    ],
    "timeline": [
      {
        "date": "2021-01-10T00:00:00.000Z",
        "event_title": "Início do cumprimento",
        "progression": "Fechado",
        "event_type": ""
      },
      {
        "date": "2022-04-11T00:00:00.000Z",
        "event_title": "Progressão de regime",
        "progression": "Semi-aberto",
        "event_type": "progressão",
        "base_date": "2021-01-10T00:00:00.000Z",
        "base_date_reference": "início do cumprimento"
      }
    ]
  }
}

Calculadoras

Calcula a progressão de regime

Calcula os marcos de progressão de regime a partir das condenações, do regime inicial e dos eventos que alteram o prazo (remições, detrações, faltas graves e suspensões), aplicando a estratégia escolhida em calculation_strategy (DEFAULT ou ART76). A resposta traz as datas previstas de progressão (progressions), a linha do tempo do cumprimento (timeline) e os totais de dias (pena, detração, remição e suspensão).

Os campos nature_crime_id e condition_convict_id referenciam dados do backend e devem existir; caso contrário a resposta é 404.

POST

api

calculadoras

progressao-regime

Calcula a progressão de regime

curl --request POST \
  --url https://api.jusfy.dev/calculators/api/calculadoras/progressao-regime \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "Progressão de regime - exemplo",
  "convict_info": {
    "customer": {
      "id": 1,
      "name": "Fulano de Tal",
      "document": null
    },
    "number_lawsuit": "0001234-56.2024.8.26.0100"
  },
  "redemptions": [],
  "detractions": [],
  "serious_fault": [],
  "suspensions": [],
  "type_initial_regime": "FECHADO",
  "calculation_strategy": "DEFAULT",
  "condemnations": [
    {
      "criminal_sentences": [
        {
          "type_description": "Roubo (art. 157, CP)",
          "crime_date": "2021-01-10",
          "nature_crime_id": 1,
          "condition_convict_id": 1,
          "penalty_time": {
            "years": 5,
            "months": 0,
            "days": 0
          }
        }
      ],
      "start_date": "2021-01-10",
      "is_considered_serious_fault": false
    }
  ]
}
'

import requests

url = "https://api.jusfy.dev/calculators/api/calculadoras/progressao-regime"

payload = {
    "name": "Progressão de regime - exemplo",
    "convict_info": {
        "customer": {
            "id": 1,
            "name": "Fulano de Tal",
            "document": None
        },
        "number_lawsuit": "0001234-56.2024.8.26.0100"
    },
    "redemptions": [],
    "detractions": [],
    "serious_fault": [],
    "suspensions": [],
    "type_initial_regime": "FECHADO",
    "calculation_strategy": "DEFAULT",
    "condemnations": [
        {
            "criminal_sentences": [
                {
                    "type_description": "Roubo (art. 157, CP)",
                    "crime_date": "2021-01-10",
                    "nature_crime_id": 1,
                    "condition_convict_id": 1,
                    "penalty_time": {
                        "years": 5,
                        "months": 0,
                        "days": 0
                    }
                }
            ],
            "start_date": "2021-01-10",
            "is_considered_serious_fault": False
        }
    ]
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Progressão de regime - exemplo',
    convict_info: {
      customer: {id: 1, name: 'Fulano de Tal', document: null},
      number_lawsuit: '0001234-56.2024.8.26.0100'
    },
    redemptions: [],
    detractions: [],
    serious_fault: [],
    suspensions: [],
    type_initial_regime: 'FECHADO',
    calculation_strategy: 'DEFAULT',
    condemnations: [
      {
        criminal_sentences: [
          {
            type_description: 'Roubo (art. 157, CP)',
            crime_date: '2021-01-10',
            nature_crime_id: 1,
            condition_convict_id: 1,
            penalty_time: {years: 5, months: 0, days: 0}
          }
        ],
        start_date: '2021-01-10',
        is_considered_serious_fault: false
      }
    ]
  })
};

fetch('https://api.jusfy.dev/calculators/api/calculadoras/progressao-regime', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.jusfy.dev/calculators/api/calculadoras/progressao-regime",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Progressão de regime - exemplo',
    'convict_info' => [
        'customer' => [
                'id' => 1,
                'name' => 'Fulano de Tal',
                'document' => null
        ],
        'number_lawsuit' => '0001234-56.2024.8.26.0100'
    ],
    'redemptions' => [
        
    ],
    'detractions' => [
        
    ],
    'serious_fault' => [
        
    ],
    'suspensions' => [
        
    ],
    'type_initial_regime' => 'FECHADO',
    'calculation_strategy' => 'DEFAULT',
    'condemnations' => [
        [
                'criminal_sentences' => [
                                [
                                                                'type_description' => 'Roubo (art. 157, CP)',
                                                                'crime_date' => '2021-01-10',
                                                                'nature_crime_id' => 1,
                                                                'condition_convict_id' => 1,
                                                                'penalty_time' => [
                                                                                                                                'years' => 5,
                                                                                                                                'months' => 0,
                                                                                                                                'days' => 0
                                                                ]
                                ]
                ],
                'start_date' => '2021-01-10',
                'is_considered_serious_fault' => false
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "statusCode": 200,
  "message": "Cálculo concluído com sucesso",
  "timestamp": "2026-06-22T18:00:00.000Z",
  "path": "/api/calculadoras/progressao-regime",
  "result": {
    "detraction_days": 0,
    "redemption_days": 0,
    "suspensions_days": 0,
    "total_sentence_days": 1825,
    "reports": {
      "summary": null,
      "complete": null,
      "expert": null
    },
    "progressions": [
      {
        "date_to_progression": "2022-04-11T00:00:00.000Z",
        "progression_title": "Progressão para o regime semiaberto"
      }
    ],
    "timeline": [
      {
        "date": "2021-01-10T00:00:00.000Z",
        "event_title": "Início do cumprimento",
        "progression": "Fechado",
        "event_type": ""
      },
      {
        "date": "2022-04-11T00:00:00.000Z",
        "event_title": "Progressão de regime",
        "progression": "Semi-aberto",
        "event_type": "progressão",
        "base_date": "2021-01-10T00:00:00.000Z",
        "base_date_reference": "início do cumprimento"
      }
    ]
  }
}

Autorizações

x-api-key

string

header

obrigatório

Corpo

application/json

Payload da calculadora de progressão de regime.

Payload da progressão de regime. Informe as condenações (com as penas e os ids de natureza/condição), o regime inicial, a estratégia de cálculo e os eventos que alteram o prazo (remições, detrações, faltas graves e suspensões). A resposta traz os marcos de progressão previstos, a linha do tempo do cumprimento e os totais de dias.

name

string

obrigatório

Nome do cálculo. Não afeta o resultado.

convict_info

object

obrigatório

Dados do réu/processo. Exigidos pelo schema, mas não afetam o resultado.

Show child attributes

redemptions

object[]

obrigatório

Remições (dias remidos por trabalho/estudo).

Show child attributes

detractions

object[]

obrigatório

Detrações (períodos de prisão a descontar).

Show child attributes

serious_fault

object[]

obrigatório

Faltas graves ocorridas ao longo do cumprimento.

Show child attributes

suspensions

object[]

obrigatório

Suspensões da contagem do prazo.

Show child attributes

type_initial_regime

enum<string>

obrigatório

Regime inicial de cumprimento.

Opções disponíveis:

FECHADO,

SEMIABERTO,

ABERTO

calculation_strategy

enum<string>

obrigatório

Estratégia de cálculo da progressão.

Opções disponíveis:

DEFAULT,

ART76

condemnations

object[]

obrigatório

Condenações. Deve conter pelo menos uma.

Show child attributes

Resposta

Resultado da progressão, com marcos previstos, linha do tempo e totais.

The response is of type object.

Legado

Calculadoras

Consultas

JusScore

Health

Calcula a progressão de regime

Autorizações

Corpo

Resposta