Sign in

v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB
Timeoff > Leave

Reads a single Leave

Reads a single Leave

get/api/2026-07-01/resources/timeoff/leaves/{id}

Path parameters

idstring required

The leave ids to retrieve

Response

OK

idstring required

Identifier of the Leave

company_idstring required

Company identifier of the employee of the leave

employee_idstring required

Employee identifier of the leave

start_onstring required

The start date of the leave

finish_onstring

The end date of the leave

half_daystring

Indicates if the leave is taken as a half-day

descriptionstring

A description of the leave

reasonstring

The reason provided by the employee for taking the leave

leave_type_idstring

The identifier for the type of leave

leave_type_namestring

The name of the leave type

approvedboolean

Indicates whether the leave has been approved

employee_full_namestring

The full name of the employee taking the leave

start_timestring

The start time of the leave

hours_amount_in_centsinteger

The total number of hours taken for the leave, represented in cents

updated_atstring required

The updated at date of the leave

created_atstring

The created at date of the leave

deleted_atstring

The date when the leave was deleted

duration_attributesstring

The duration attributes of the leave

days_takennumber required

Number of days taken for paid leave

Example response

{
  "id": "1",
  "company_id": "1",
  "employee_id": "1",
  "start_on": "2028-09-05",
  "finish_on": "2028-09-05",
  "description": "Annual family vacation",
  "reason": "Medical appointment",
  "leave_type_id": "36",
  "approved": true,
  "employee_full_name": "Bob The Boss",
  "start_time": "09:00",
  "hours_amount_in_cents": 800,
  "updated_at": "2028-03-11T17:03:12.000Z",
  "created_at": "2028-03-11T17:03:12.000Z",
  "deleted_at": "2028-03-11T17:03:12.000Z",
  "days_taken": 1
}