> ## 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 hours compensation absence types available for employees

> Returns the absence types with category hours compensation that are active, not deleted and assigned (directly or through company, office, department or group) to **every** employee in `employeeIds`. Use it to pick the `absenceTypeId` for `POST /overtime-policies/v1/compensations/rest`. The API consumer needs permission over every requested employee; an employee of another company makes the request fail with 403.



## OpenAPI

````yaml GET /schedule/v1/employees/available-hours-compensation-types
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/employees/available-hours-compensation-types:
    get:
      tags:
        - Absence Types
      summary: List hours compensation absence types available for employees
      description: >-
        Returns the absence types with category hours compensation that are
        active, not deleted and assigned (directly or through company, office,
        department or group) to **every** employee in `employeeIds`. Use it to
        pick the `absenceTypeId` for `POST
        /overtime-policies/v1/compensations/rest`. The API consumer needs
        permission over every requested employee; an employee of another company
        makes the request fail with 403.
      operationId: ListAvailableHoursCompensationTypes
      parameters:
        - in: query
          name: employeeIds[]
          required: true
          description: Employee IDs. Repeat the parameter for several employees.
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
              format: uuid
      responses:
        '200':
          description: >-
            Hours compensation absence types available for every requested
            employee. Empty array when they share none.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      required:
                        - absenceTypeId
                        - name
                      properties:
                        absenceTypeId:
                          type: string
                          format: uuid
                          description: >-
                            Hours compensation absence type ID. Valid value for
                            `absenceTypeId` in `POST
                            /overtime-policies/v1/compensations/rest`.
                        name:
                          type: string
                          description: Display name of the absence type
                          example: Compensación de horas
                  meta:
                    type: object
                    properties:
                      currentPage:
                        type: integer
                        example: 1
                      lastPage:
                        type: integer
                        example: 1
                      total:
                        type: integer
                        example: 1
                      perPage:
                        type: integer
                        example: 1
              example:
                data:
                  - absenceTypeId: 199932f8-c295-42b9-8588-b5ec181a3767
                    name: Compensación de horas
        '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
        '403':
          description: >-
            Forbidden - The API consumer has no permission over one of the
            requested employees, or the company has no absences module.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
        '422':
          description: >-
            Unprocessable Entity - Validation errors:


            - `employeeIds` missing, empty or not an array

            - `validator.employee_not_found` - one of the employees does not
            exist
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Validation error message key
                  errors:
                    type: object
                    description: Field-specific validation errors
        '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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.