Untether LabsDevelopers

Get Request

gethttps://app.untetherlabs.com/api/v1/time-off/requests/{requestId}

Get a specific time off request

Path parameters#

requestIduuid
Required

Query parameters#

expandstring

Available expansions: policy, provider, rejectedBy

See Query Parameters for more information on expansions.

Response 200#

createdAtstring
Required
statusTimeOffRequestStatus
Required
pending
approved
rejected
cancelled
pending_sync
sync_failed
startDatestring
Required
endDatestring
Required
policyIduuid
Required
policyTimeOffPolicy
Show TimeOffPolicy properties
createdAtstring
Required
typeenum
Required
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
namestring
Required
descriptionstring | null
Required
accrualUnitone of
Required
Option 1 — AccrualUnit
enum
hours
days
propertiesany
payCodeIduuid | null
Required

The pay code for which associated time will be paid out.

payCodeone of
Option 1 — PayCode
namestring
Required
shorthandNamestring
Required
hexColorstring
Required
typeenum
Required
hours
days
money
valuenumber
Required
providerIduuid
Required
providerProvider
Show Provider properties
namestring | null
Required
emailstring
Required
hireDatestring | null
Required
statusenum
Required
onboarding
active
dismissed
unmanaged
teamIduuid | null
Required
licensedRegionsstring[]
Required
employmentTypeuuid | null
Required
notestring | null
Required
dailyHoursDailyHours
Required
datestring
Required

ISO timestamp of the date for the daily hours.

durationnumber
Required

Number of hours requested off for this day.

paidHoursnumber
Required

The total number of hours that will be paid out for this time off request.

rejectedByIduuid

Only present for rejected time off requests, the user who rejected the request.

rejectedByUser
typeUserType
Required
user
bot
namestring
Required
emailstring
Required
statusEmploymentStatus
Required
onboarding
active
dismissed
unmanaged
isAdminboolean
Required
rejectionReasonstring | null

Only present for rejected time off requests, reason may be null for unspecified.

syncErrorobject | null

Present for pending_sync requests, contains the latest Rippling sync status and error message.

statusenum
Required
success
failed
messagestring | null
Required
createdAtstring
Required
conflictResolutionenum | null

The shift conflict resolution strategy selected when this request was approved.

delete
deleteWithOpen
callout
calloutWithOpen
keep
keepWithOpen
null
isFullDayboolean | 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#

validation400

Input validation failed.

Show extension members
pathstring
messagestring
Required
time-off-request-not-found404

A specified time off request does not exist in the system.