# Get Request

> GET /v1/time-off/requests/{requestId}

`GET https://app.untetherlabs.com/api/v1/time-off/requests/{requestId}`

Get a specific time off request

## Request

```bash
curl -X GET 'https://app.untetherlabs.com/api/v1/time-off/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -H 'Authorization: Bearer $UNTETHER_API_KEY'
```

## Path parameters

- `requestId` (uuid, required)

## Query parameters

- `expand` (string) — Available expansions: `policy`, `provider`, `rejectedBy` See [Query Parameters](/using-the-api/query-parameters) for more information on expansions.

## Response 200

- `createdAt` (string, required, example "2024-11-20T07:43:34+0000")
- `status` (TimeOffRequestStatus, required, one of `pending`, `approved`, `rejected`, `cancelled`, `pending_sync`, `sync_failed`)
- `startDate` (string, required, example "2024-11-20T07:43:34+0000")
- `endDate` (string, required, example "2024-11-20T07:43:34+0000")
- `policyId` (uuid, required)
- `policy` (TimeOffPolicy)
  - `createdAt` (string, required, example "2024-11-20T07:43:34+0000")
  - `type` (enum, required, example "vacation", one of `bereavement`, `floating-holiday`, `holiday-pay`, `jury-duty`, `learning-and-development`, `paid-time-off`, `vacation`, `parental-leave`, `personal-day`, `sick`, `volunteer`, `weather`, `wellness`, `flex-day`, `marriage-code`, `unpaid-day`, and 2 more)
  - `name` (string, required, example "QC Vacation")
  - `description` (string | null, required, example "Vacation policy for Quebec-based employees.")
  - `accrualUnit` (one of, required)
    - Option 1: AccrualUnit
  - `properties` (any)
  - `payCodeId` (uuid | null, required) — The pay code for which associated time will be paid out.
  - `payCode` (one of)
    - Option 1: PayCode
      - `name` (string, required, example "Overtime")
      - `shorthandName` (string, required, example "OT")
      - `hexColor` (string, required, example "#f97316")
      - `type` (enum, required, one of `hours`, `days`, `money`)
      - `value` (number, required, example 1.5)
- `providerId` (uuid, required)
- `provider` (Provider)
  - `name` (string | null, required, example "Bruce Wayne")
  - `email` (string, required, example "bruce.wayne@goodhealth.com")
  - `hireDate` (string | null, required, example "2024-11-20T07:43:34+0000")
  - `status` (enum, required, example "active", one of `onboarding`, `active`, `dismissed`, `unmanaged`)
  - `teamId` (uuid | null, required)
  - `licensedRegions` (string[], required)
  - `employmentType` (uuid | null, required)
- `note` (string | null, required, example "Going on vacation with my family.")
- `dailyHours` (DailyHours, required)
  - `date` (string, required, example "2024-10-06T00:00:00.000Z") — ISO timestamp of the date for the daily hours.
  - `duration` (number, required, example 8) — Number of hours requested off for this day.
- `paidHours` (number, required, example 32) — The total number of hours that will be paid out for this time off request.
- `rejectedById` (uuid) — Only present for rejected time off requests, the user who rejected the request.
- `rejectedBy` (User)
  - `type` (UserType, required, one of `user`, `bot`)
  - `name` (string, required)
  - `email` (string, required)
  - `status` (EmploymentStatus, required, one of `onboarding`, `active`, `dismissed`, `unmanaged`)
  - `isAdmin` (boolean, required)
- `rejectionReason` (string | null) — Only present for rejected time off requests, reason may be null for unspecified.
- `syncError` (object | null) — Present for pending_sync requests, contains the latest Rippling sync status and error message.
  - `status` (enum, required, one of `success`, `failed`)
  - `message` (string | null, required)
  - `createdAt` (string, required, example "2024-11-20T07:43:34+0000")
- `conflictResolution` (enum | null, one of `delete`, `deleteWithOpen`, `callout`, `calloutWithOpen`, `keep`, `keepWithOpen`, `null`) — The shift conflict resolution strategy selected when this request was approved.
- `isFullDay` (boolean | null) — Whether the request blocks whole calendar days rather than the dailyHours windows. Null for requests created before this field existed; treated as full-day when the policy accrues in days.

## Errors

- `validation` (400) — Input validation failed.
- `time-off-request-not-found` (404) — A specified time off request does not exist in the system.