---
title: "Validate a time off request"
method: POST
path: "/v1/org/{orgId}/timeoff/request/validate"
tags: ["timeoff"]
---

# Validate a time off request

`POST /v1/org/{orgId}/timeoff/request/validate`

## Path parameters

- `orgId` string, required

## Query parameters

- `ignoreRequestId` string

## Request body

- TimeOffRequest
  - `startDate` string, date, required
  - `startDatePartialDay` number
  - `startDatePartialDayPeriod` 'AM' | 'PM'
  - `endDate` string, date, required
  - `endDatePartialDay` number
  - `endDatePartialDayPeriod` 'AM' | 'PM'
  - `personId` string
  - `typeDescription` string
  - `timeOffPolicyId` string
  - `note` string

## Response `201`

time off validated

- CalculatedTimeOffBalance
  - `daysTaken` number, required
  - `hoursTaken` number, required
  - `balanceBeforeRequest` number
  - `carryOverBeforeRequest` number
  - `balanceAfterRequest` number
  - `carryOverAfterRequest` number
  - `excludedDays` ExcludedDay[], required
    - `date` string, date, required
    - `dayLabel` string, required
  - `approverJobId` string
  - `errorMessage` string

## Other responses

- `400` — bad request
- `401` — not authorized
- `404` — not found
- `500` — Not Implemented

---

[API](https://skmtc.dev/charthop/apis/charthop-api.md) · [All operations](https://skmtc.dev/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/charthop/charthop-api/revisions/4685d95a20b1/schema)