USusemultiplier
timeoff

Retrieve time off details by ID

Changed on

Get detailed information about a specific time off request by its unique identifier.

This endpoint allows you to:

  • Retrieve complete details of a time off request
  • View the current status and approval state
  • Access time off dates, duration, and description
  • See time off type information
get/v1/timeoffs/{timeOffId}

Request

Path parameters

timeOffIdstring required

Unique identifier of the time off request

Response

Time off details retrieved successfully

timeOffIdstring uuid required

Unique identifier for the time off

status'DRAFT' | 'APPROVAL_IN_PROGRESS' | 'APPROVED' | 'REJECTED' | 'TAKEN' | 'DELETED' | 'REVOKED' required

Current status of the time off request

noOfDaysnumber float required

Number of days for the time off (calculated)

descriptionstring

Description or reason for the time off

createdOnstring date-time

Timestamp when the time off was created

updatedOnstring date-time

Timestamp when the time off was last updated

Example response

{
  "timeOffId": "660e8400-e29b-41d4-a716-446655440003",
  "status": "APPROVED",
  "startDate": {
    "date": "2025-11-15",
    "session": "FULL_DAY"
  },
  "endDate": {
    "date": "2025-11-15",
    "session": "FULL_DAY"
  },
  "noOfDays": 6,
  "description": "Family vacation",
  "type": {
    "typeId": "550e8400-e29b-41d4-a716-446655440001",
    "key": "annual"
  },
  "createdOn": "2025-10-23T10:30:00Z",
  "updatedOn": "2025-10-23T11:45:00Z"
}

Changes