---
title: "Listar apontamentos"
method: GET
path: "/tickets/{ticket_number}/appointments"
tags: ["Apontamentos"]
---

# Listar apontamentos

`GET /tickets/{ticket_number}/appointments`

## Request

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

Lista os apontamentos de um determinado ticket.

## Path parameters

- `ticket_number` integer, required

## Query parameters

- `offset` integer
- `limit` integer
- `user_id` integer
- `start_date` string, date
- `end_date` string, date

## Response `200`

- object[]
  - `id` integer, required: Identificador do apontamento
  - `client` object, required: *Objeto representando o **cliente** vinculado no apontamento*
    - `id` integer: Identificador do client
    - `name` string: Nome do cliente
  - `date` string, date, required: Dia em que o atendimento foi realizado
  - `init_time` string, required: Horário de início do atendimento. No formato **HH:MM**
  - `end_time` string, required: Horário de fim do atendimento. No formato **HH:MM**
  - `description` string, required: Descrição do apontamento
  - `external_user_name` string, nullable: Nome do usuário que executou a ação em uma ferramenta externa
  - `user` object, required: *Objeto representando o **atendente** que realizou o apontamento*
    - `id` integer: Identificador do usuário
    - `name` string: Nome do usuário
  - `locations` object[], required: *Lista de **geolocalizações** vinculadas no apontamento*
    - `id` integer: Identificador da geolocalização
    - `latitude` string: Latitude
    - `longitude` string: Longitude
  - `valorization` object, nullable, required: *Este objeto contém as informações de **valorização do apontamento**. Suas informações de valores só serão preenchidas caso o apontamento seja um apontamento com valorização*
    - `attendance` 'External' | 'Remote' | 'Internal': Atendimento: externo, remoto ou interno
    - `attendance_kind` 'Loose' | 'Contract': Tipo de atendimento: avulso ou contrato
    - `contract` object, nullable: *Objeto representando o **contrato** vinculado no apontamento*
      - `id` integer: Identificador do contrato
      - `name` string: Nome do contrato
    - `contract_rider` object, nullable: *Objeto representando o **adendo do contrato** vinculado no apontamento, que identifica o ciclo de apuração. Nulo quando o apontamento não tem contrato.*
      - `id` integer: Identificador do adendo do contrato
      - `rider_number` integer: Número do adendo
      - `release` integer: Número da versão do adendo
      - `modality` string, nullable: Modalidade do contrato, com o mesmo texto do campo `modality` da listagem de contratos
    - `loose_service` object, nullable: *Objeto representando o **serviço avulso** vinculado no apontamento*
      - `id` integer: Identificador do serviço avulso
      - `name` string: Nome do serviço avulso
    - `guarantee` boolean: Apontado como garantia?
    - `manual_value` boolean: Definido um valor manual?
    - `shift` object, nullable: *Objeto representando o **deslocamento** vinculado no apontamento*
      - `id` integer: Identificador do deslocamento
      - `name` string: Nome do deslocamento
      - `value` string: Valor do deslocamento
    - `shift_owner_ticket` object, nullable: *Objeto representando o **ticket cujo deslocamento foi aproveitado** neste apontamento (deslocamento carona)*
      - `ticket_number` integer: Número do ticket que possui o deslocamento
      - `title` string: Título do ticket que possui o deslocamento
    - `value` string: Valor do apontamento

## 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 os parâmetros informados**

## Changes

- **2026-10-27** `98fe904b6118`: 1 info
  - added the optional property `items/valorization/contract_rider` to the response with the `200` status
- **2026-08-18** `0a0749d4f66b`: 2 info
  - added the optional property `items/external_user_name` to the response with the `200` status
  - added the optional property `items/valorization/shift_owner_ticket` to the response with the `200` status

[Operation history](https://skmtc.dev/tiflux/apis/tiflux-official-api/changes/tickets/:ticket_number/appointments/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)