> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# List out of office entries

> Lists the connected user's out-of-office entries.

`calcom.listOutOfOfficeEntries` lists the connected user's out-of-office entries.

```ts automations/list-out-of-office-entries.automation.ts theme={null}
import { automation, markSignificant } from "automate.ax"
import { calcom } from "automate.ax/calcom"

export default automation("List out of office entries", () => {
  markSignificant(
    calcom.listOutOfOfficeEntries({ skip: 0, take: 250, sortStart: "asc" }),
  )
})
```

## Input

Pass these fields:

| Field       | Type              | Required | Description                                           |
| ----------- | ----------------- | -------- | ----------------------------------------------------- |
| `skip`      | `integer`         | No       | Default: `0`. Minimum: 0.                             |
| `sortEnd`   | `"asc" \| "desc"` | No       | —                                                     |
| `sortStart` | `"asc" \| "desc"` | No       | —                                                     |
| `take`      | `integer`         | No       | Default: `250`. Must be greater than 0. Maximum: 250. |

## Output

Returns an array. Each item has these fields:

| Field      | Type                                                                    | Required | Description                                                                             |
| ---------- | ----------------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------- |
| `userId`   | `number`                                                                | Yes      | The ID of the user.                                                                     |
| `toUserId` | `number`                                                                | No       | The ID of the user covering for the out of office period, if applicable.                |
| `id`       | `number`                                                                | Yes      | The ID of the ooo entry.                                                                |
| `uuid`     | `string`                                                                | Yes      | The UUID of the ooo entry.                                                              |
| `start`    | `string (date-time)`                                                    | Yes      | The start date and time of the out of office period in ISO 8601 format in UTC timezone. |
| `end`      | `string (date-time)`                                                    | Yes      | The end date and time of the out of office period in ISO 8601 format in UTC timezone.   |
| `notes`    | `string`                                                                | No       | Optional notes for the out of office entry.                                             |
| `reason`   | `"unspecified" \| "vacation" \| "travel" \| "sick" \| "public_holiday"` | No       | the reason for the out of office entry, if applicable                                   |

Cal.com enforces account role, plan, and availability requirements. Provider rejections surface as structured action failures with the HTTP status and any `Retry-After` delay.