---
title: "Search for Employees' Agreed Hours in particular status"
method: POST
path: "/management/v2/agreed_hours"
tags: ["Agreed Hour"]
---

# Search for Employees' Agreed Hours in particular status

`POST /management/v2/agreed_hours`

## Request

- Base URL: `https://your-subdomain.deputy.deputy.com/api`
- URL: `https://your-subdomain.deputy.deputy.com/api/management/v2/agreed_hours`
- Auth: API key in header `OAuth`

Search for Employees' Agreed Hours in particular status.

## Response `200`

A successful response.

- AgreedHourSearchResponse
  - `agreedHour` V2modelAgreedHour[]
    - `threshold` number, float
    - `applyThreshold` boolean
    - `workPeriod` ModelWorkPeriod
      - `cycle` 'WEEKLY' | 'TWO_WEEK' | 'FOUR_WEEK'
      - `dayOfWeek` 'SUNDAY' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY'
      - `startDate` string, date-time: Must refer to a day of the week matching `dayOfWeek`, otherwise an error occurs.
      - `startCycleDate` string, date-time
      - `endCycleDate` string, date-time
      - `endDate` string, date-time
      - `baselineDate` string, date-time
      - `baselineComment` string
      - `changesReason` 'UNDEFINED' | 'REQUESTED_BY_EMPLOYEE' | 'BONA_FIDE' | 'OTHER'
      - `metadata` string
    - `details` ModelAgreedHourDetails
      - `weeks` ModelAgreedHourWeek[]
        - `week` 'UNSPECIFIED' | 'ONE' | 'TWO' | 'THREE' | 'FOUR'
        - `days` ModelAgreedHourDay[]
          - `day` integer
          - `shifts` ModelAgreedHourShift[]
            - `startTime` string
            - `endTime` string
            - `breaks` ModelBreakTime[]
              - …
            - `location` integer
            - `area` integer
            - `totalHours` number, float
            - `changeDetails` string
    - `workingDaysPerCycle` number, float
    - `status` 'UNKNOWN' | 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'FORCED'
    - `statusDate` string, date-time
    - `statusChangedById` integer
    - `comment` string
    - `version` string
    - `createdAt` string, date-time
    - `archivedAt` string, date-time
    - `recordId` string
    - `creatorEmployeeProfileId` string
    - `creatorEmployeeDisplayName` string
    - `creatorEmployeeProfilePic` string
    - `effectiveDate` string
  - `error` string
  - `currentVersion` string

---

[API](https://skmtc.dev/deputy/apis/deputy-v2-api.md) - [All operations](https://skmtc.dev/deputy/apis/deputy-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/deputy/apis/deputy-v2-api/revisions/78f0278f4608?raw)