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

# List fixed items

> Retrieve fixed remuneration items matching a set of filters



## OpenAPI

````yaml /openapi-specs/pagga-remuneration.yaml get /remuneration/api/fixed-items
openapi: 3.1.0
info:
  title: Lucca-Compensation
  version: '1.0'
  description: >-
    Welcome on the documentation for the Lucca Compensation API.


    Lucca Compensation is an online compensation management service that offers
    a complete picture of compensation structure (basic salary, variable
    compensation item, ...). 
  contact:
    name: API Support
    url: https://support.lucca.fr
    email: contact@luccasoftware.com
  license:
    name: Unlicensed
    url: https://www.luccasoftware.com
servers:
  - url: https://{host}
    description: Your Lucca account URL.
    variables:
      host:
        default: example.ilucca.net
        description: >-
          The URL of your dedicated Lucca account: `{account}.{env}.{region}`.


          Account reflects your company name. Env indicates the environment.
          Region depends on your server location.


          **Please, use your test or sandbox environments (and not your
          production env.) for testing purposes.**


          Environments:

          - `ilucca`: production environment for customers.

          - `ilucca-test`: test environment for customers.

          - `ilucca-demo`: demo environment for prospects.


          Regions:

          - `.ch` for Swiss located accounts.

          - `.net` for the others.


          Regarding sandboxes, the pattern differs:
          `https://{account}-{sandboxName}.sandbox.{server}.luccasoftware.com`,
          where:

          - `{sandboxName}` is automatically generated upon creation.

          - `{server}` may be "eu1", "eu2" or "ch1".
security: []
tags:
  - name: fixed-nature
    description: Represents a type of remuneration that is fixed, i.e. does not vary.
  - name: fixed-nature-category
    description: Represents a category of fixed-nature.
  - name: variable-nature
    description: Represents a type of remuneration that varies.
  - name: variable-nature-category
    description: Represents a category of variable-natures.
  - name: RemunerationNatures
    description: Types of remuneration.
  - name: variable-item
    description: Represents a remuneration item of type "variable-nature".
  - name: fixed-item
    description: Represents a remuneration item of type "fixed-nature".
paths:
  /remuneration/api/fixed-items:
    get:
      tags:
        - fixed-item
      summary: List fixed items
      description: Retrieve fixed remuneration items matching a set of filters
      operationId: ListFixedItems
      parameters:
        - name: ids
          in: query
          description: Only return variable items with the specified identifiers.
          schema:
            uniqueItems: true
            type: array
            items:
              type: integer
              format: int32
        - name: amendedWorkContractIds
          in: query
          description: "Only return fixed natures linked to the specified amended work contracts.\r\nAn amended work contract id is a string representation of a pair of work contract id and amendment id.\r\n    If the amendment id is null, the work contract id is enough : `12`\r\n    Otherwise, the work contract id and the amendment id are separated by a dash : `12-4`\""
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: ownerIds
          in: query
          description: Only return variable items owned by the specified users.
          schema:
            uniqueItems: true
            type: array
            items:
              type: integer
              format: int32
        - name: natureIds
          in: query
          description: Only return variable items with the specified natures.
          schema:
            uniqueItems: true
            type: array
            items:
              type: integer
              format: int32
        - name: limit
          description: For paging. Number of items per page.
          in: query
          allowEmptyValue: true
          schema:
            type: integer
            default: 10
        - name: page
          in: query
          description: |-
            Two strategy might be used:

            - Continuation token paging
            - Offset limit paging
          allowEmptyValue: true
          schema:
            oneOf:
              - type: string
              - type: integer
          examples:
            Continuation token paging:
              value: next_token&fields.root=next
            Offset limit paging:
              value: '2'
        - name: sort
          in: query
          description: >-
            This parameters syntax is consistent among every Lucca application,
            and its BNF grammar is defined as follow.

            ```bnf

            <sort>                  ::= '-|+'? <property> ( ',' <property> )*

            <property>              ::= <strictString> ( '.' <strictString> )*

            <strictString>          ::= ( <char> | <digit> | '_' | '-' )+

            ```
          allowEmptyValue: true
          schema:
            type: string
            default: StartsOn
          examples:
            Asc sorting:
              value: id
            Desc sorting:
              value: '-id'
            Multi properties sorting comma separated:
              value: name,legalentity.name
            Multi properties sorting ampersand separated:
              value: sort=age&sort=-score
        - name: fields.root
          in: query
          description: >-
            Retrieve prev & next page tokens, as well as the total count of
            items across all pages.
          allowEmptyValue: true
          style: form
          explode: false
          schema:
            type: array
            items:
              enum:
                - next
                - prev
                - count
              type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FixedItemPage'
components:
  schemas:
    FixedItemPage:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/FixedItem'
        next:
          type:
            - string
            - 'null'
        prev:
          type:
            - string
            - 'null'
        count:
          type:
            - integer
            - 'null'
          format: int32
      additionalProperties: false
    FixedItem:
      type: object
      properties:
        id:
          type: integer
          description: Unique identifier of the fixed remuneration item
          format: int32
        amount:
          type: number
          description: "The amount of the fixed remuneration item.\r\nDepending on the nature of the fixed item, the amount can be either a quantity or a monetary value."
          format: double
        startsOn:
          type: string
          description: The first day on which the fixed remuneration item applies.
          format: date
        endsOn:
          type:
            - string
            - 'null'
          description: The last day on which the fixed remuneration item applies.
          format: date
        comment:
          type:
            - string
            - 'null'
          description: You can attach a comment to explain or justify the variable item
          example: First-half salary increase
        natureId:
          type: integer
          description: The nature id of the fixed remuneration item
          format: int32
        nature:
          allOf:
            - $ref: '#/components/schemas/FixedNature'
          description: The nature of the fixed remuneration item
        workContractId:
          type: integer
          description: A fixed item must be linked to a work contract.
          format: int32
        workContract:
          allOf:
            - $ref: '#/components/schemas/AmendedWorkContract'
          description: The work contract linked to the fixed item.
      additionalProperties: false
      description: A fixed remuneration item
    FixedNature:
      type: object
      properties:
        id:
          type: integer
          description: An unique identifier for the fixed nature
          format: int32
        name:
          maxLength: 50
          minLength: 1
          type: string
          description: The display name
          example: Basic salary
        category:
          anyOf:
            - $ref: '#/components/schemas/FixedNatureCategory'
              description: Fixed nature category
            - type: 'null'
        establishments:
          description: Establishments linked to the fixed nature
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/Establishment'
      additionalProperties: false
      description: Fixed nature
    AmendedWorkContract:
      type: object
      properties:
        workContractId:
          type: integer
          description: "An amended work contract is defined both by the work contract and the amendment\r\nThis is the identifier of the work contract part"
          format: int32
        amendmentId:
          type: integer
          description: "An amended work contract is defined both by the work contract and the amendment\r\nThis is the identifier of the amendment part"
          format: int32
        ownerId:
          type: integer
          description: The identifier of the employee who owns the contract
          format: int32
        owner:
          $ref: '#/components/schemas/AmendedWorkContractOwner'
          description: The employee who owns the work contract
        startsOn:
          type: string
          description: Start date of the contract
          format: date
        endsOn:
          type:
            - string
            - 'null'
          description: End date of the contract
          format: date
      additionalProperties: false
    FixedNatureCategory:
      type: object
      properties:
        id:
          type: integer
          description: An unique identifier for the fixed nature category
          format: int32
        code:
          type:
            - string
            - 'null'
          description: An internal unique code identifying the category
          example: BASIC_SALARY
      additionalProperties: false
      description: Fixed nature category
    Establishment:
      type: object
      properties:
        id:
          type: integer
          description: An unique identifier for the establishment
          format: int32
        name:
          type: string
          description: The display name
          example: Lucca FR
        currencyCode:
          type: string
          description: Currency code used in this establishment
          example: EUR
        currencySymbol:
          type: string
          description: Currency symbol used in this establishment
          example: €
      additionalProperties: false
    AmendedWorkContractOwner:
      required:
        - department
        - displayName
        - firstName
        - id
        - lastName
        - login
        - name
      type: object
      properties:
        id:
          type: integer
          description: Unique identifier of the user
          format: int32
        firstName:
          type: string
          description: First name of the user
        lastName:
          type: string
          description: Last name of the user
        name:
          type: string
          description: Full name of the user
        displayName:
          type: string
          description: Display name of the user

````