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

# List validated overtime requests (history)

> Returns all overtime validations of the authenticated company that have reached a final status (accepted, rejected or autoApproved). Pending validations are excluded.



## OpenAPI

````yaml GET /schedule/v1/overtime-validation/history
openapi: 3.0.0
info:
  description: ''
  version: 3.0.0
  title: Sesame Public API
servers:
  - url: https://api-{region}.sesametime.com
    variables:
      region:
        default: eu1
security: []
tags: []
paths:
  /schedule/v1/overtime-validation/history:
    get:
      tags:
        - Overtime Validation
      summary: List validated overtime requests (history)
      description: >-
        Returns all overtime validations of the authenticated company that have
        reached a final status (accepted, rejected or autoApproved). Pending
        validations are excluded.
      operationId: ListOvertimeValidationHistory
      parameters:
        - in: query
          name: page
          description: Page number (1-based)
          schema:
            type: integer
            default: 1
        - in: query
          name: limit
          description: Items per page
          schema:
            type: integer
            default: 20
        - in: query
          name: status
          description: Filter by one or more validation statuses. Comma-separated values.
          schema:
            type: array
            items:
              type: string
              enum:
                - accepted
                - rejected
                - autoApproved
          explode: false
        - in: query
          name: employeeIds
          description: Filter by one or more employee identifiers. Comma-separated UUIDs.
          schema:
            type: array
            items:
              type: string
              format: uuid
          explode: false
        - in: query
          name: from
          description: >-
            Filter validations by date (Y-m-d) greater than or equal to this
            value
          schema:
            type: string
            format: date
            example: '2025-01-01'
        - in: query
          name: to
          description: Filter validations by date (Y-m-d) less than or equal to this value
          schema:
            type: string
            format: date
            example: '2025-03-31'
        - in: query
          name: orderKey
          description: Field used for ordering
          schema:
            type: string
            enum:
              - date
              - status
            default: date
        - in: query
          name: orderType
          description: Order direction
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
      responses:
        '200':
          description: >-
            Paginated list of validated overtime requests for the authenticated
            company
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      required:
                        - id
                        - employee
                        - date
                        - requestedSeconds
                        - approvedSeconds
                        - status
                        - createdAt
                        - validatedAt
                        - managementHistory
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: Overtime validation identifier
                        employee:
                          type: object
                          description: Basic employee information
                          required:
                            - id
                            - firstName
                            - lastName
                          properties:
                            id:
                              type: string
                              format: uuid
                            firstName:
                              type: string
                              example: Ana
                            lastName:
                              type: string
                              example: Garcia
                        date:
                          type: string
                          format: Y-m-d
                          example: '2020-01-01'
                        requestedSeconds:
                          type: integer
                          description: >-
                            Raw overtime in seconds the employee
                            requested/clocked beyond their schedule (real clock
                            time minus the tolerance/minimum-to-count
                            threshold).
                          example: 3600
                        approvedSeconds:
                          type: integer
                          description: >-
                            Net overtime in seconds approved and counting toward
                            the employee balance (raw overtime plus hours-bag
                            adjustments). Equals requestedSeconds when the
                            employee has no hours-bag configured.
                          example: 7200
                        status:
                          type: string
                          enum:
                            - accepted
                            - rejected
                            - autoApproved
                          description: Validation status
                        createdAt:
                          type: string
                          format: Y-m-dTH:i:sP
                          example: '2020-01-01T10:00:00+01:00'
                        validatedAt:
                          type: string
                          format: date-time
                          nullable: true
                          description: >-
                            Moment when the validation transitioned to a final
                            status
                          example: '2025-04-15T09:22:31+02:00'
                        managementHistory:
                          type: array
                          description: >-
                            Chronological list of approval/rejection actions
                            taken by managers (ascending by createdAt)
                          items:
                            type: object
                            required:
                              - managerId
                              - managerName
                              - status
                              - comment
                              - createdAt
                            properties:
                              managerId:
                                type: string
                                format: uuid
                              managerName:
                                type: string
                                nullable: true
                                example: Carlos Lopez
                              status:
                                type: string
                                enum:
                                  - accepted
                                  - rejected
                                description: Action taken by the manager
                              comment:
                                type: string
                                nullable: true
                              createdAt:
                                type: string
                                format: Y-m-dTH:i:sP
                                example: '2020-01-01T10:00:00+01:00'
                  meta:
                    type: object
                    properties:
                      currentPage:
                        type: integer
                        example: 1
                      lastPage:
                        type: integer
                        example: 1
                      total:
                        type: integer
                        example: 1
                      perPage:
                        type: integer
                        example: 1
        '401':
          description: Unauthorized - Invalid or missing API Key
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message indicating authentication failure
                    example: Invalid or missing API Key
                  code:
                    type: string
                    description: Error code for programmatic handling
                    example: UNAUTHORIZED
              example:
                message: Invalid or missing API Key
                code: UNAUTHORIZED
        '429':
          description: Too Many Requests - Rate limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message indicating rate limit exceeded
                    example: Rate limit exceeded. Please try again later.
                  code:
                    type: string
                    description: Error code for programmatic handling
                    example: RATE_LIMIT_EXCEEDED
                  retryAfter:
                    type: integer
                    description: Number of seconds to wait before retrying
                    example: 60
              example:
                message: Rate limit exceeded. Please try again later.
                code: RATE_LIMIT_EXCEEDED
                retryAfter: 60
      security:
        - Bearer: []
components:
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````