> ## Documentation Index
> Fetch the complete documentation index at: https://developers.tarefy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consulta o timesheet de um usuário

> Consulta os lançamentos de horas e as justificativas de um usuário no intervalo informado. As datas são inclusivas e interpretadas como dias UTC.

O usuário consultado precisa pertencer à conta autenticada. Consultar outra pessoa exige a permissão 12 ou nível 5 (Super Admin). Justificativas de outros usuários só são retornadas com a permissão 11 ou nível 5; sem esses privilégios, a resposta inclui justificativas apenas do próprio usuário autenticado. Lançamentos de tarefas também respeitam as regras de visibilidade dessas tarefas.



## OpenAPI

````yaml /api-reference/comecar.yaml get /v2/user/timesheet
openapi: 3.0.0
info:
  title: Tarefy API
  description: >-
    Tarefy REST API — task management, culture and performance platform.


    Endpoints are versioned at `/v2/...`. Authentication via Bearer JWT in the
    `Authorization` header.


    To get started, see the [authentication guide](/authentication) and the
    [quickstart](/quickstart).
  version: 2.0.0
  contact:
    name: Tarefy Support
    email: suporte@tarefy.com
    url: https://tarefy.com
  license:
    name: Proprietary
    url: https://tarefy.com
servers:
  - url: https://app.tarefy.com/nodeapi
    description: Production
security:
  - bearerAuth: []
tags:
  - name: User
    description: Login, profile, session
  - name: API Tokens
    description: Persistent tokens for integrations
  - name: Accounts
    description: Organization account
paths:
  /v2/user/timesheet:
    get:
      tags:
        - User
      summary: Consulta o timesheet de um usuário
      description: >-
        Consulta os lançamentos de horas e as justificativas de um usuário no
        intervalo informado. As datas são inclusivas e interpretadas como dias
        UTC.


        O usuário consultado precisa pertencer à conta autenticada. Consultar
        outra pessoa exige a permissão 12 ou nível 5 (Super Admin).
        Justificativas de outros usuários só são retornadas com a permissão 11
        ou nível 5; sem esses privilégios, a resposta inclui justificativas
        apenas do próprio usuário autenticado. Lançamentos de tarefas também
        respeitam as regras de visibilidade dessas tarefas.
      operationId: getUserTimesheet
      parameters:
        - name: userId
          in: query
          required: true
          description: ID positivo do usuário pertencente à conta autenticada.
          schema:
            type: integer
            minimum: 1
            example: 739
        - name: startDate
          in: query
          required: true
          description: Primeiro dia do intervalo, inclusive, no formato YYYY-MM-DD.
          schema:
            type: string
            format: date
            example: '2026-09-21'
        - name: endDate
          in: query
          required: true
          description: >-
            Último dia do intervalo, inclusive, no formato YYYY-MM-DD. Não pode
            ser anterior a startDate.
          schema:
            type: string
            format: date
            example: '2026-09-27'
      responses:
        '200':
          description: Timesheet retornado com sucesso
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - tasks
                  - justify
                  - message
                properties:
                  status:
                    type: boolean
                    enum:
                      - true
                  tasks:
                    type: array
                    description: >-
                      Lançamentos agrupados por tarefa e dia; lançamentos
                      manuais permanecem separados.
                    items:
                      type: object
                      required:
                        - data
                        - task
                      properties:
                        data:
                          type: object
                          description: >-
                            Lançamento de horas. Em registros automáticos do
                            mesmo dia e tarefa, seconds contém a soma dos
                            lançamentos.
                          required:
                            - id
                            - task
                            - user
                            - seconds
                          properties:
                            id:
                              type: integer
                            task:
                              type: integer
                            user:
                              type: integer
                            date:
                              type: string
                              format: date
                              nullable: true
                            seconds:
                              type: integer
                            manual:
                              type: boolean
                              nullable: true
                            task_dad:
                              type: integer
                              nullable: true
                            external_source:
                              type: string
                              nullable: true
                            external_id:
                              type: string
                              nullable: true
                            created_at:
                              type: string
                              format: date-time
                              nullable: true
                            updated_at:
                              type: string
                              format: date-time
                              nullable: true
                        task:
                          type: object
                          description: >-
                            Dados da tarefa associada, incluindo
                            time_worked_total e informações relacionadas
                            visíveis ao solicitante.
                          properties:
                            time_worked_total:
                              type: integer
                              description: Total de segundos registrados para a tarefa.
                  justify:
                    type: array
                    description: >-
                      Justificativas de ausência no intervalo, sujeitas à
                      permissão 11 para usuários diferentes do solicitante.
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                        id_user:
                          type: integer
                          nullable: true
                        conta_id:
                          type: integer
                          nullable: true
                        text:
                          type: string
                          nullable: true
                        time:
                          type: integer
                          nullable: true
                        date:
                          type: string
                          format: date
                          nullable: true
                        created_at:
                          type: string
                          format: date-time
                          nullable: true
                        updated_at:
                          type: string
                          format: date-time
                          nullable: true
                  message:
                    type: string
                    example: Consulta realizada com sucesso.
              example:
                status: true
                tasks: []
                justify: []
                message: Consulta realizada com sucesso.
        '400':
          description: >-
            userId inválido, datas ausentes ou fora do formato YYYY-MM-DD, ou
            startDate posterior a endDate.
        '401':
          description: Usuário não autenticado ou sessão inválida.
        '403':
          description: >-
            Usuário consultado não pertence à conta autenticada ou o solicitante
            não tem a permissão 12 nem nível 5 (Super Admin) para consultar
            outra pessoa.
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````