---
title: "Listar histórico do grupo de contrato"
method: GET
path: "/contract-groups/{id}/histories"
tags: ["Contratos"]
---

# Listar histórico do grupo de contrato

`GET /contract-groups/{id}/histories`

## Request

- Base URL: `https://api.tiflux.com/api/v2`
- URL: `https://api.tiflux.com/api/v2/contract-groups/{id}/histories`
- Auth: HTTP bearer

Lista as alterações registradas no grupo de contrato (modalidade Compartilhado), da mais recente para a mais antiga. Como no painel, o histórico é o do grupo: os contratos que compõem o grupo não têm histórico próprio na API, e `GET /contracts/{id}/histories` responde 404 para eles.

> Os campos `value` e `discount_value` serão exibidos apenas para usuários com a permissão <span style="white-space: nowrap; margin:1px; padding:1px 8px; font-weight:bold; border-radius:12px;  background-color: var(--light-red, var(--input-bg)); color:var(--red); border:1px solid var(--red)">Visualizar valores dos tickets</span>. Caso o usuário não possua esta permissão, esses campos retornarão `"--"` na resposta.

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

- object[]
  - `id` number, required: Identificador do registro de histórico
  - `rider_number` number: Número do adendo vigente quando a alteração foi registrada
  - `release` number: Número da revisão do adendo
  - `value` union: Valor do adendo no momento da alteração. Retorna "--" para quem não pode ver valores. Nulo no registro de adendo removido (status 2)
    - number
    - string
  - `discount_value` union: Desconto do adendo no momento da alteração. Retorna "--" para quem não pode ver valores
    - number
    - string
  - `discount_type` number, nullable: Tipo do desconto
  - `start_date` string, date, nullable: Data de início do adendo
  - `description` string, nullable, required: Descrição da alteração. Alterações feitas por esta API têm o prefixo "[API] ". Nulo no registro de adendo removido (status 2)
  - `status` number, nullable: Tipo do registro: 0 = adendo ou revisão criado, 1 = alteração no contrato ou no adendo, 2 = adendo removido, 3 = contrato criado, 4 = adendo editado ou aviso de consumo enviado por e-mail
  - `created_at` string, date-time, required: Data e hora da alteração
  - `updated_by` object, nullable: Usuário que fez a alteração
    - `id` number: Identificador do usuário
    - `name` string: Nome do usuário

## Other responses

- `403`: ### **Problemas com permissão** Essa resposta significa que o seu usuário está autenticado corretamente, porém, não possui a permissão ou licença necessária para acessar essa rota
- `404`: ### **Grupo de contrato não encontrado**

## Changes

- **2026-10-21** `4dfeaf315e4e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tiflux/apis/tiflux-official-api/changes/contract-groups/:id/histories/get.md)

---

[API](https://skmtc.dev/tiflux/apis/tiflux-official-api.md) - [All operations](https://skmtc.dev/tiflux/apis/tiflux-official-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tiflux/apis/tiflux-official-api/revisions/2936ac99a76d?raw)