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

# Busca resumo de saldos mensais do colaborador no ciclo



## OpenAPI

````yaml https://api.pre.pontua.tech/api/public/doc-json get /banco-horas/ciclos/{cicloId}/{colaboradorId}/resumo
openapi: 3.0.0
info:
  title: Pontua Public API
  description: >-
    API oficial da Pontua para integrações de clientes externos. Autentique com
    o token gerado no dashboard em **Configurações → API**. Envie o token no
    header `Authorization: Bearer <SEU_TOKEN>`.
  version: '1.0'
  contact: {}
servers: []
security: []
tags: []
paths:
  /banco-horas/ciclos/{cicloId}/{colaboradorId}/resumo:
    get:
      tags:
        - Banco de Horas
      summary: Busca resumo de saldos mensais do colaborador no ciclo
      operationId: BancoHorasController_BuscarResumo
      parameters:
        - name: cicloId
          required: true
          in: path
          description: Id do ciclo do banco de horas
          schema:
            example: a2f2cbed-e141-465c-a769-f1591be5f35c
            type: string
        - name: colaboradorId
          required: true
          in: path
          description: Id do colaborador
          schema:
            example: a2f2cbed-e141-465c-a769-f1591be5f35c
            type: string
      responses:
        '200':
          description: Resumo de saldos mensais do colaborador no ciclo
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ResumoSaldoMesDto'
        default:
          description: "\n\t\t\t400 - Bad Request: A solicitação não está no formato correto.\n\t\t\t401 - Unauthorized: A solicitação não foi autorizada. Verifique se o token de acesso é válido.\n\t\t\t403 - Forbidden: Acesso proibido! Requer um nível de permissão mais elevado.\n\t\t\t404 - Not Found: O recurso solicitado não foi encontrado.\n\t\t\t500 - Internal Server Error: Erro de execução no servidor!\n\t\t\t"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
      deprecated: false
      security:
        - bearer: []
components:
  schemas:
    ResumoSaldoMesDto:
      type: object
      properties:
        inicioMes:
          type: string
          description: Data inicial (dd/MM/yyyy) para o cálculo de frequência do mês
          example: 01/01/2022
        fimMes:
          type: string
          description: Data final (dd/MM/yyyy) para o cálculo de frequência do mês
          example: 31/01/2022
        cargaHorariaTotal:
          type: string
          description: Carga horária total esperada
          example: '8:48'
        horasTrabalhadasTotal:
          type: string
          description: Total de horas trabalhadas
          example: '8:00'
        saldoTotal:
          type: string
          description: >-
            Total do saldo comparativo entre os horários de entrada e saída
            reais e os esperados, positivo ou negativo
          example: '+7:23'
        bancoHorasTotal:
          type: string
          description: Total de horas de banco de horas
          example: '+0:48'
      required:
        - inicioMes
        - fimMes
        - horasTrabalhadasTotal
        - saldoTotal
    ErrorDto:
      type: object
      properties:
        service:
          type: string
          description: Rota solicitada
        method:
          type: string
          description: Método http
        message:
          description: Mensagem do erro
          oneOf:
            - type: string
              example: message erro
            - type: array
              items:
                type: string
                example:
                  - erro 1
                  - erro 2
      required:
        - service
        - method
        - message

````