---
title: "Listar histórico do ticket"
method: GET
path: "/tickets/{ticket_number}/histories"
tags: ["Tickets"]
---

# Listar histórico do ticket

`GET /tickets/{ticket_number}/histories`

## Request

- Base URL: `https://api.tiflux.com/api/v2`
- URL: `https://api.tiflux.com/api/v2/tickets/{ticket_number}/histories`
- Auth: HTTP bearer

Consulta detalhada do histórico de um determinado ticket.

## Path parameters

- `ticket_number` integer, required

## Query parameters

- `offset` integer
- `limit` integer
- `history_of` 0 | 1, required
- `type_id_attr` integer
- `operation` 'created' | 'updated' | 'deleted'

## Response `200`

- object[]: Lista de registros de histórico do ticket
  - `id` integer, required: Identificador (ID) do histórico do ticket
  - `_created_at` string, required: Data e hora em que o histórico foi criado
  - `_operation` 'created' | 'updated' | 'deleted', required: Operação que originou o histórico (criação, atualização ou remoção)
  - `_type` string, required: Categoria ou área do ticket em que a mudança ocorreu
  - `_type_id_attr` integer, nullable: Campo de identificação entre os registros e as alterações feitas no histórico (ex: ID do apontamento)
  - `action` string, required: Descrição resumida da ação registrada no histórico
  - `action_details` object, required: Detalhamento adicional sobre a ação realizada, com chaves dinâmicas
  - `changes` object, required: Conjunto de alterações realizadas durante a ação
    - `fields` string[], required: Lista de nomes dos campos que foram alterados
    - `new_values` object, required: Novos valores dos campos modificados
    - `old_values` object, required: Valores antigos dos campos, antes da modificação
  - `user` object, nullable, required: Usuário responsável pela ação registrada no histórico (pode ser nulo para ações automáticas)
    - `id` integer, required: ID do usuário que realizou a ação
    - `name` string, required: Nome do usuário que realizou a ação
    - `email` string, required: E-mail do usuário que realizou a ação

## 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`: ### **Ticket não encontrado**
- `422`: ### **Problemas com algum valor de atributo informado**

---

[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)