> ## 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.

# Get slot reservation

> Retrieves one Cal.com slot reservation.

`calcom.getSlotReservation` retrieves one Cal.com slot reservation.

```ts automations/get-slot-reservation.automation.ts theme={null}
import { automation, markSignificant } from "automate.ax"
import { calcom } from "automate.ax/calcom"

export default automation("Get slot reservation", () => {
  markSignificant(calcom.getSlotReservation({ uid: "reservation-uid" }))
})
```

## Input

Pass these fields:

| Field | Type     | Required | Description |
| ----- | -------- | -------- | ----------- |
| `uid` | `string` | Yes      | —           |

## Output

Returns the active reservation, or `null` when Cal.com has no active hold for that UID.

| Field              | Type      | Required | Description                          |
| ------------------ | --------- | -------- | ------------------------------------ |
| `eventTypeId`      | `integer` | Yes      | Event type that owns the slot.       |
| `slotStart`        | `string`  | Yes      | Reserved slot start.                 |
| `slotEnd`          | `string`  | Yes      | Reserved slot end.                   |
| `slotDuration`     | `number`  | Yes      | Slot duration in minutes.            |
| `reservationUid`   | `string`  | Yes      | Reservation identifier.              |
| `reservationUntil` | `string`  | Yes      | Time when Cal.com releases the hold. |

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.
