---
title: findTimeOff()
slug: findtimeoff
docTags: 
createdAt: 2021-09-14T16:33:14.000Z
---

Returns time off over a period of time, either for one individual person or across the org. Any time off that overlaps part of the date range being queried will be returned.

### Syntax

`findTimeOff(from, until[, person])`

### Parameters

| **Parameter** | **Type**                                | **Description**                                                                           |
| ------------- | --------------------------------------- | ----------------------------------------------------------------------------------------- |
| `from`        | [Date](docId\:xTAQdzvLBTAKjxRnpFwe9)    | Starting point of the date range to traverse (inclusive)                                  |
| `until`       | [Date](docId\:xTAQdzvLBTAKjxRnpFwe9)    | Ending point of the date range to traverse (exclusive)                                    |
| `person`      | [Person](docId\:BZrX1MTDjk8CgkAW7UjQJ)  | The person's time off to query. If not passed, returns all time off across the whole org. |

### Return Type

[Sequence](docId\:JG4itlQWafzLpArttFo67) \<[TimeOff](docId\:raHsIHytvR1NsKqtdfkJA)>&#x20;

### Examples

`findTimeOff(date, "+1m").count()`

Returns the number of time off requests (including those pending and not approved) that are occurring in the next 30 days.

`findTimeOff("2025-10-01", "2025-11-01").filter{status:approved}.count()`

Returns the number of time off requests that have been approved that occur in the month of October.

`findTimeOff("2025-10-01", "2025-11-01", person).filter{status:approved}.sum{days}`

Returns the total number of days off for a particular person for time off overlapping the month of October.

`findTimeOff("2025-01-01", "2026-01-01").filter{status:approved and policy.name:"UK Sick Policy"}.sum{days}`

Returns the total number of days off taken for approved time off requests for the "UK Sick Policy" that overlap the calendar year 2025.