> ## 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 dias de turno de colaboradores de acordo com os filtros ## OpenAPI ````yaml https://api.pre.pontua.tech/api/public/doc-json get /turnos/days 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 `. version: '1.0' contact: {} servers: [] security: [] tags: [] paths: /turnos/days: get: tags: - Turno summary: Busca dias de turno de colaboradores de acordo com os filtros operationId: TurnosController_findDays parameters: - name: searchText description: Texto pesquisado para filtrar consulta required: false in: query schema: type: string - name: pagina description: Página que deseja retornar os resultados required: false in: query schema: example: 0 type: number - name: limite description: Quantidade de itens que retorna na consulta. Min 1 - Max 100 required: false in: query schema: example: 100 type: number - name: initialDate required: true in: query description: Data inicial para filtro schema: format: date-time example: '2026-01-01T00:00:00.000Z' type: string - name: finalDate required: true in: query description: Data final para filtro schema: format: date-time example: '2026-01-31T00:00:00.000Z' type: string - name: positionIds required: false in: query description: 'Filtro por IDs de cargo, separados por vírgula. Ex: "id1,id2"' schema: type: string - name: departmentIds required: false in: query description: 'Filtro por IDs de departamento, separados por vírgula. Ex: "id1,id2"' schema: type: string - name: teamIds required: false in: query description: 'Filtro por IDs de equipe, separados por vírgula. Ex: "id1,id2"' schema: type: string - name: shiftIds required: false in: query description: 'Filtro por IDs de turno, separados por vírgula. Ex: "id1,id2"' schema: type: string - name: businessUnitIds required: false in: query description: >- Filtro por IDs de unidade de negócio, separados por vírgula, Ex: "id1,id2" schema: type: string - name: costCenterIds required: false in: query description: >- Filtro por IDs de centro de custo, separados por vírgula, Ex: "id1,id2" schema: type: string - name: shiftTypes required: false in: query description: >- Filtro por tipos de turno, separados por vírgula. Ex.: "turnoFixo,turnoFlexivel,turnoRevezamento,turnoCiclo" schema: type: string responses: '200': description: Lista de dias de turno content: application/json: schema: $ref: '#/components/schemas/ShiftDaysDto' 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: ShiftDaysDto: type: object properties: page: type: number description: Página retornada example: 0 limit: type: number description: Número de resultados por página example: 10 total: type: number description: Total de colaboradores example: 10 collaborators: description: Dias de turno dos colaboradores type: array items: $ref: '#/components/schemas/CollaboratorShiftDaysDto' alerts: description: Alertas de irregularidades type: array items: $ref: '#/components/schemas/ShiftDayAlertDto' required: - total - collaborators - alerts 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 CollaboratorShiftDaysDto: type: object properties: id: type: string description: ID do colaborador example: 123-456abc name: type: string description: Nome do colaborador example: Fulano de Tal documentNumber: type: string description: CPF ou CNPJ do colaborador example: '15621118054' photo: type: string description: Url para download da foto example: https://s3-bucket.s3.amazonaws.com/files/tenant_x/file.jpg days: description: Dias do colaborador type: array items: $ref: '#/components/schemas/ShiftDayDto' required: - id - name - documentNumber - days ShiftDayAlertDto: type: object properties: collaboratorId: type: string description: ID do colaborador example: 123-456abc collaboratorName: type: string description: Nome do colaborador example: Fulano de Tal date: format: date-time type: string description: Data do dia example: '2026-01-01T00:00:00.000Z' alert: type: string description: Alerta enum: - >- Há registros de ponto em um dia configurado como Folga/DSR/Compensado - Colaborador escalado não realizou marcações de ponto neste dia - 'Atenção: esta troca gera excesso de dias consecutivos de trabalho' - Nos últimos 30 dias, não há registro de folga ou DSR em domingo example: Colaborador escalado não realizou marcações de ponto neste dia required: - collaboratorId - collaboratorName - date - alert ShiftDayDto: type: object properties: date: format: date-time type: string description: Data do dia example: '2026-01-01T00:00:00.000Z' type: type: string description: Tipo do dia enum: - NORMAL - COMPENSADO - DSR - FOLGA default: NORMAL shiftType: type: string description: Tipo do turno enum: - turnoFixo - turnoFlexivel - turnoRevezamento default: turnoFixo isFromShiftException: type: boolean description: Indica se a configuração veio de uma exceção de turno default: false isFromDayException: type: boolean description: Indica se a configuração veio de uma exceção de dia default: false isVacation: type: boolean description: Indica se é um dia de férias default: false isLeave: type: boolean description: Indica se é um dia de afastamento default: false isInShutdown: type: boolean description: Indica se é um dia em período de um fechamento aprovado default: false required: - date - type - shiftType - isFromShiftException - isFromDayException - isVacation - isLeave - isInShutdown ````