Get a leave request by id

Status

Introduction

Files

Organization Structure API

Axis-sections
Departments
Legal-Units
Establishments

Core HR API

Employees Directory
Guides

Cleemy Expenses API

Expense-temp-items
Expense-claims
Expense-claim-items

Timmi Absences API

Timmi Office API

User-locations
Work-locations

Timmi Project API

Clients
Projects
Project services
Organizations
Financials

Timmi Settings API

UserDates
Workcycle-exceptions
Working-time-arrangement

Timmi Timesheet API

Time-entries
Timesheets
Reports
Guides

Pagga Mealvouchers API

Statutory
Computation

Pagga Remuneration API

Fixed-natures
Fixed-items
Variable-natures
Variable-items

Poplee Training API

Training-demands
Realized-trainings

GET

api

leaveRequests

{leaveRequestId}

curl --request GET \
  --url https://{account}-{sandboxName}.sandbox.{server}.luccasoftware.com/api/v3/leaveRequests/{leaveRequestId}

{
  "data": {
    "id": 123,
    "leavePeriodId": 123,
    "leavePeriod": {
      "id": 123,
      "ownerId": 123,
      "isConfirmed": true,
      "confirmationDate": null,
      "attachmentId": null,
      "leaves": [
        {
          "id": "<string>",
          "date": "2023-12-25",
          "isAm": true,
          "leaveAccountId": 123,
          "leaveAccount": {
            "id": 123,
            "name": "<string>"
          },
          "leavePeriodId": 123,
          "leavePeriod": {},
          "value": "<string>",
          "creationDate": "2023-11-07T05:31:56Z",
          "isActive": true,
          "cancellationDate": null,
          "cancellationUserId": null,
          "comment": "<string>"
        }
      ],
      "logs": [
        {
          "id": 123,
          "date": "2023-11-07T05:31:56Z",
          "comment": "<string>",
          "status": 0
        }
      ]
    },
    "status": 0,
    "creationDate": "2023-11-07T05:31:56Z",
    "nextApproverId": null,
    "cancellationUserId": null,
    "cancellationDate": null,
    "isActive": true,
    "approvals": [
      {
        "id": 123,
        "date": "2023-11-07T05:31:56Z",
        "approverId": 123,
        "substitutedApproverId": null,
        "approved": true,
        "comment": "<string>"
      }
    ],
    "cancellationRequests": [
      {
        "id": 123,
        "authorId": 123,
        "comment": "<string>",
        "rank": 0,
        "approved": true,
        "creationDate": "2023-11-07T05:31:56Z",
        "nextApproverId": null,
        "isActive": true
      }
    ]
  }
}

Path Parameters

leaveRequestId

string

required

Response

200

application/json

data

object

data.id

integer

Unique identifier for the LeaveRequest

data.leavePeriodId

integer

Unique identifier for the attached LeavePeriod

data.leavePeriod

object

data.leavePeriod.id

number

Unique identifier for the LeavePeriod

data.leavePeriod.ownerId

number

Unique identifier for the user

data.leavePeriod.isConfirmed

boolean

Has the value true for approved LeavePeriod or the value false for LeavePeriod pending approval

data.leavePeriod.confirmationDate

string | null

Time at which the LeavePeriod was approved

data.leavePeriod.attachmentId

string | null

Unique identifier for the attached document

data.leavePeriod.leaves

object[]

data.leavePeriod.leaves.id

string

required

Unique identifier for the Leave

data.leavePeriod.leaves.date

string

required

Date of the leave in ISO format yyyy-mm-dd

data.leavePeriod.leaves.isAm

boolean

required

Has the value true for morning or the value false for afternoon

data.leavePeriod.leaves.leaveAccountId

integer

required

Unique identifier for the attached LeaveAccount

data.leavePeriod.leaves.leavePeriodId

integer

required

Unique identifier for the attached LeavePeriod

data.leavePeriod.leaves.leaveAccount

object

LeaveAccounts are the type of absences that can be selected by the user

Fields

data.leavePeriod.leaves.leavePeriod

object

data.leavePeriod.leaves.value

string | null

Leave duration in hours

data.leavePeriod.leaves.creationDate

string

Time at which the object was created

data.leavePeriod.leaves.isActive

boolean

Has the value true when the Leave exists (for pending or confirmed LeavePeriods), or the value false when it has been deleted (for canceled or denied LeaveRequests).

data.leavePeriod.leaves.cancellationDate

string | null

Time at which the request was canceled

data.leavePeriod.leaves.cancellationUserId

integer | null

Unique identifier for the user who canceled the request

data.leavePeriod.leaves.comment

string

Comments

data.leavePeriod.logs

object[]

data.status

enum<number>

Status of the Leave request. Can be :

0 = PENDING_APPROVAL

2 = APPROVED

3 = DENIED

4 = CANCELLED

5 = CANCELLATION_PENDING

Available options:

0,

2,

3,

4,

5

data.creationDate

string

Time at which the object was created

data.nextApproverId

integer | null

Unique identifier for the next approver

data.cancellationUserId

integer | null

Unique identifier for the user that cancelled the Leave Request

data.cancellationDate

string | null

Time at which the object was cancelled

data.isActive

boolean

Has the value true for acitve Leave Request or the value false for cancelled Leave Request

data.approvals

object[]

data.cancellationRequests

object[]

Was this page helpful?

List leave requests The leave-request-approval resource

curl --request GET \
  --url https://{account}-{sandboxName}.sandbox.{server}.luccasoftware.com/api/v3/leaveRequests/{leaveRequestId}

{
  "data": {
    "id": 123,
    "leavePeriodId": 123,
    "leavePeriod": {
      "id": 123,
      "ownerId": 123,
      "isConfirmed": true,
      "confirmationDate": null,
      "attachmentId": null,
      "leaves": [
        {
          "id": "<string>",
          "date": "2023-12-25",
          "isAm": true,
          "leaveAccountId": 123,
          "leaveAccount": {
            "id": 123,
            "name": "<string>"
          },
          "leavePeriodId": 123,
          "leavePeriod": {},
          "value": "<string>",
          "creationDate": "2023-11-07T05:31:56Z",
          "isActive": true,
          "cancellationDate": null,
          "cancellationUserId": null,
          "comment": "<string>"
        }
      ],
      "logs": [
        {
          "id": 123,
          "date": "2023-11-07T05:31:56Z",
          "comment": "<string>",
          "status": 0
        }
      ]
    },
    "status": 0,
    "creationDate": "2023-11-07T05:31:56Z",
    "nextApproverId": null,
    "cancellationUserId": null,
    "cancellationDate": null,
    "isActive": true,
    "approvals": [
      {
        "id": 123,
        "date": "2023-11-07T05:31:56Z",
        "approverId": 123,
        "substitutedApproverId": null,
        "approved": true,
        "comment": "<string>"
      }
    ],
    "cancellationRequests": [
      {
        "id": 123,
        "authorId": 123,
        "comment": "<string>",
        "rank": 0,
        "approved": true,
        "creationDate": "2023-11-07T05:31:56Z",
        "nextApproverId": null,
        "isActive": true
      }
    ]
  }
}