> ## 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 compensations assigned to an employee

> Returns all compensations currently assigned to the employee via their active salary.



## OpenAPI

````yaml GET /contract/v1/employees/{employeeId}/compensations
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:
  /contract/v1/employees/{employeeId}/compensations:
    get:
      tags:
        - Employee Compensations
      summary: List compensations assigned to an employee
      description: >-
        Returns all compensations currently assigned to the employee via their
        active salary.
      operationId: ListEmployeeCompensations
      parameters:
        - name: employeeId
          in: path
          description: The employee ID
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      description: >-
                        Assignment of a compensation to an employee salary with
                        date range
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: Assignment ID
                        compensationId:
                          type: string
                          format: uuid
                          description: Compensation ID
                        salaryId:
                          type: string
                          format: uuid
                          nullable: true
                          description: >-
                            Salary ID (auto-resolved from employee active
                            salary)
                        startDate:
                          type: string
                          format: date
                          description: Start date of the compensation assignment
                          example: '2024-01-01'
                        endDate:
                          type: string
                          format: date
                          nullable: true
                          description: >-
                            End date of the compensation assignment (null for
                            ongoing)
                          example: '2024-12-31'
                        createdAt:
                          type: string
                          format: Y-m-dTH:i:sP
                          example: '2020-01-01T10:00:00+01:00'
                        updatedAt:
                          type: string
                          format: Y-m-dTH:i:sP
                          example: '2020-01-01T10:00:00+01:00'
                        compensation:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                              description: Compensation ID
                            companyId:
                              type: string
                              format: uuid
                              description: Company ID
                            name:
                              type: string
                              description: Compensation name
                              example: Comision por ventas
                            compensationType:
                              type: string
                              enum:
                                - fixed
                                - variable
                                - additional
                              description: >-
                                Compensation type: fixed (requires quantity),
                                variable or additional (require quantity OR
                                percentage)
                            quantity:
                              type: number
                              nullable: true
                              description: >-
                                Fixed amount (mutually exclusive with
                                percentage)
                              example: 1500
                            percentage:
                              type: number
                              nullable: true
                              description: >-
                                Percentage of gross salary (mutually exclusive
                                with quantity)
                              example: 10.5
                            period:
                              type: string
                              enum:
                                - weekly
                                - biweekly
                                - fortnightly
                                - monthly
                              description: Payment period (yearly is NOT valid for payroll)
                            currency:
                              type: string
                              description: Currency code (ISO 4217)
                              example: MXN
                            recurrence:
                              type: integer
                              description: Payment recurrence
                              example: 1
                            status:
                              type: string
                              enum:
                                - active
                                - inactive
                              description: Compensation status
                            origin:
                              type: string
                              enum:
                                - payroll
                                - general
                              nullable: true
                              description: Origin of the compensation
                            code:
                              type: string
                              nullable: true
                              description: External code (for Contpaqi integration)
                            comment:
                              type: string
                              nullable: true
                              description: Optional comment
                            createdAt:
                              type: string
                              format: Y-m-dTH:i:sP
                              example: '2020-01-01T10:00:00+01:00'
                            updatedAt:
                              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
        '404':
          description: Not Found - The requested resource could not be found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message indicating the resource was not found
                    example: Evaluation not found
                  code:
                    type: string
                    description: Error code for programmatic handling
                    example: EVALUATION_NOT_FOUND
              example:
                message: >-
                  Evaluation with ID 123e4567-e89b-12d3-a456-426614174000 was
                  not found
                code: EVALUATION_NOT_FOUND
        '429':
          description: Too Many Requests - Rate limit exceeded
      security:
        - Bearer: []
components:
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````