---
title: "Audit for an Employee's Agreed Hours for a time period"
method: POST
path: "/management/v2/agreed_hours/audit/{employeeId}"
tags: ["Agreed Hour"]
---

# Audit for an Employee's Agreed Hours for a time period

`POST /management/v2/agreed_hours/audit/{employeeId}`

## Request

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

Audit for an Employee's Agreed Hours for a time period.

## Path parameters

- `employeeId` string, required

## Response `200`

A successful response.

- AgreedHourAuditResponse
  - `items` AuditResponseAgreedHourWithConsentRecords[]
    - `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[]
              - …
      - `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
    - `consentRecords` ModelConsent[]
      - `id` string
      - `recordId` string
      - `recordType` 'SHIFT' | 'TIMESHEET' | 'REGULAR_SCHEDULE'
      - `transactionId` string
      - `employeeId` integer
      - `status` 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'CANCELLED' | 'OVERRIDDEN_ACCEPTED'
      - `description` string
      - `metadata` ModelShiftTypeConsentMetadata
        - `comment` string
        - `extras` object
      - `creator` integer
      - `createdAt` string, date-time
  - `error` 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)