---
title: "Details of the working hours"
method: GET
path: "/v2/providers/employers/employees/employments/workinghours/{workinghoursId}"
tags: ["Working hours"]
---

# Details of the working hours

`GET /v2/providers/employers/employees/employments/workinghours/{workinghoursId}`

## Request

- Base URL: `https://api.loket.nl`
- URL: `https://api.loket.nl/v2/providers/employers/employees/employments/workinghours/{workinghoursId}`
- Auth: none required

__Activity name :__  <a href="https://developer.loket.nl/Activities/GetWorkingHoursByWorkingHoursId" target="_blank">GetWorkingHoursByWorkingHoursId</a> <br/> <br/>  Get the details of a working hours record

## Path parameters

- `workinghoursId` string, uuid, required

## Headers

- `Authorization` string, required
- `Accept` string, required

## Response `200`

OK

- object: a warning indacateds that the given payload is valide, however take notice of the warning this might ifluence behavour.
  - `version` Version
    - `obsoleteDate` string, date, nullable: The date (can be null) on which the `resourceVersion` is no longer supported/available
    - `resourceVersion` string, date: The resource version of the object in the response
  - `messages` object[]
    - `type` string: Indication of the type of message. See [the general documentation for more information](./#section/Response/Messages)
    - `description` string: Describes the message
    - `id` string, uuid, nullable: In some cases when the message may relate to a specific entity, or specific group of entities, this field provides the identifier of that entity
    - `code` integer: Identifying code for the message
    - `properties` string[]: An array that can contain additional information
  - `content` Workinghours
    - `id` string, uuid: The unique identifier of an object (GUID/UUID)
    - `startDate` string, date: Start date of the record. A (linked chain)[./#section/Data/Date-chains] is maintained within this resource.
    - `endDate` string, date, nullable: The end date of the entity. The date is up to and including.
    - `shift` object: The shift determines the full-time hours and bonus percentage. `shift` is a metadata field within the payroll administration context. Possible values can be managed by the user.
      - `shiftNumber` integer: The number for the shift.
      - `fullTimeHoursPerWeek` number: The full time hours for an employment that is linked to this shift.
      - `bonusPercentage` number: The bonus percentage used in wage calculations for the hours made in this shift.
    - `deviatingHoursPerWeek` number, double, nullable: If this field is empty the fulltime hours are based as defined by the shift, this optional field is used to register an overwriting value. The value can be less or more then the fulltime hours a week.
    - `averageHoursPerWeek` number, double, nullable: This field can be used to register the average hours per week an employment with varying hours works. For example, 0 hour contracts and min max contracts. The value of this field does NOT directly affect the payrolling proces.
    - `deviatingSvDaysPerPeriod` integer, nullable: Sv (social insurance) days are normally calculated by hours per shift, this optional field is used to register a deviating value.
    - `averageParttimeFactor` number, double, nullable: This field is used to register the deviating value of the parttimefactor, purely for administrative purposes. The parttimefactor is normally calculated by workinghours dividing by shifthours multplied by 100. Please note that this field is not used in the actual payroll proces! For the payroll process the number of hours is used.
    - `regularWorkPattern` boolean: When the employee works the same amount of hours per day every week, then the workpattern is regular.
    - `shiftRateSickLeave` object: The shift determines the full-time hours and bonus percentage. `shiftRateSickLeave` is a metadata field within the payroll administration context. Possible values can be managed by the user.
      - `shiftNumber` integer: The key number to identify the shift to be used for calculation of daily rate in case of sick leave (ziekte).
      - `fullTimeHoursPerWeek` number: The full time hours for an employment that is linked to this shift.
      - `bonusPercentage` number: The bonus percentage used in wage calculations for the hours made in this shift.
    - `flexibleHoursContract` object, nullable: The field indicates the type of flexible contract. If not applicable, please set to NULL.
      - `key` integer
      - `value` string
    - `workPattern` object, nullable: The applicable work pattern for a period of 2 weeks can be stored in this object. Each field contains the number of work hours for that day in the 2-week period. <br /> Please note that the workPattern should be left NULL if no data is present (as opposed to filling all fields with 0) <br /> Each field represent the number of hours the employee normally works on that day.
      - `oddWeeks` object
        - `monday` number, double
        - `tuesday` number, double
        - `wednesday` number, double
        - `thursday` number, double
        - `friday` number, double
        - `saturday` number, double
        - `sunday` number, double
      - `evenWeeks` object
        - `monday` number, double
        - `tuesday` number, double
        - `wednesday` number, double
        - `thursday` number, double
        - `friday` number, double
        - `saturday` number, double
        - `sunday` number, double
    - `calculateUsingWorkPattern` object: Indications in this objects determine whether specific values should be calculated based on the bi-weekly workPattern (specified in the `workPattern` object). Onderliggende elementen geven aan of specifieke waardes berekend moeten worden op basis van het twee wekelijks werkpatroon `workPattern`
      - `leaveHours` boolean: Indicates whether then leave balances (verlof) are to be calculated based on the workpattern. If set to false and the user is not linked to a leave policy with `applyLeaveSchedule` set to true the following fields are used for the calculation `deviatingHoursPerWeek` if null `shift.fullTimeHoursPerWeek` is used
      - `hoursBrokenPeriod` boolean: Indicates whether the hours for the payrolling should be calculated based on the workpattern in broken periods. These are periods of in or out of service.
      - `hoursRegularPeriod` boolean: Indicates whether the hours for the payrolling should be calculated based on the workpattern for regular periods.
      - `daysDailyRate` boolean: Indicates whether the number of days of dailyrate should be calculated based on the workpattern. The number of days are normally calculated by the working hours.
      - `deviatingDaysAndHours` boolean: Indication whether the deviating hours per week and deviating SV-days per period are to be automatically calculated based on the workpattern. Please note (!) that any values in the deviatingHoursPerWeek and deviatingSvDaysPerPeriod fields (of this workingHours record) will be overwritten based on this calculation if true (and endDate=NULL)!
    - `contractCode` object, nullable: This field is specialy made for convenience stores. The field is the type of contract. `contractCode` is a metadata field within the employer context. Possible values can be managed by the user.
      - `key` string, uuid: The unique identifier of an object (GUID/UUID)
      - `code` integer
      - `description` string
    - `aggregatedHoursPerWeek` number, double, nullable: This read-only field provides the user with a single point of knowledge as to what number of hours per week employment is actually registered in regards to the payrolling process. This number may be respectively based on the workpattern, deviating hours per week or shift hours. If the employment is an 'on call employment' (oproepkracht/invalkracht) the number is either NULL or represents the min-hours if that is applicable. This field is especially useful for third-parties that want to know the number of hours per week (without having to apply specific Loket logic). I.e. this field is not visible in Loket GUI.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/loket/apis/loket-api.md) - [All operations](https://skmtc.dev/loket/apis/loket-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loket/apis/loket-api/revisions/32170564148f?raw)