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

# Listar apontamentos

`GET /tickets/{ticket_number}/appointments`

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
    - `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**

---

[API](https://skmtc.net/tiflux/apis/tiflux-official-api.md) · [All operations](https://skmtc.net/tiflux/apis/tiflux-official-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiflux/tiflux-official-api/revisions/c656412a58bc/schema)