Get vacation request history

Returns a paginated list of all vacation requests for the current employee.

What is returned:

Complete history of all vacation requests (past and future)
Request dates, status, and approval information
Reason for vacation (if provided)
Who approved/rejected and when

Note: This endpoint is only available for employee accounts. Supports server-side pagination, sorting, and filtering via grid query parameters.

GET/account/employee/vacations/history

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Query parameters

pagenumber

Page number (1-based)

pageSizenumber

Number of items per page

viewIdstring

View identifier for saved grid configurations

filtersstring

JSON string containing filter configuration.

Available Fields:

id (string): Vacation request ID
dateFrom (date): Vacation start date
dateTo (date): Vacation end date
status (set): Vacation request status
employeeId (string): Employee ID
statusChangedAt (date): Status change timestamp
statusChangedBy (string): User ID who changed status

Filter Structure:

[
  {
    "type": "string|number|date|set|boolean|array|task_status|task_type",
    "fieldName": "field_name",
    "value": {
      "comparison": "comparison_type",
      "value": "filter_value"
    }
  }
]

Group Filters (AND/OR Combinations):

[
  {
    "type": "group",
    "fieldName": "group0.18807479823070028",
    "value": {
      "type": "or",
      "filters": [
        {
          "type": "string",
          "fieldName": "fileName",
          "value": {
            "comparison": "contain",
            "value": "aa"
          }
        },
        {
          "type": "number",
          "fieldName": "rowCount",
          "value": {
            "comparison": ">=",
            "value": 33
          }
        }
      ]
    }
  }
]

Available Comparison Operators:

id (string): Vacation request ID (string filter). Available comparisons: contain, not_contain, equal, starts_with, ends_with, is_empty, is_not_empty
dateFrom (date): Vacation start date (date filter). Available comparisons: equal, not_equal, >, <, >=, <=, between, lastMonth, thisMonth, is_empty, is_not_empty
dateTo (date): Vacation end date (date filter). Available comparisons: equal, not_equal, >, <, >=, <=, between, lastMonth, thisMonth, is_empty, is_not_empty
status (set): Vacation request status (set filter). Available comparisons: in, not_in, is_empty, is_not_empty
employeeId (string): Employee ID (string filter). Available comparisons: contain, not_contain, equal, starts_with, ends_with, is_empty, is_not_empty
statusChangedAt (date): Status change timestamp (date filter). Available comparisons: equal, not_equal, >, <, >=, <=, between, lastMonth, thisMonth, is_empty, is_not_empty
statusChangedBy (string): User ID who changed status (string filter). Available comparisons: contain, not_contain, equal, starts_with, ends_with, is_empty, is_not_empty

Note: Use quickSearch parameter for simple text search instead of adding it to filters.

sortstring

JSON array of sort objects.

Sortable Fields:

id: Vacation request ID
dateFrom: Vacation start date
dateTo: Vacation end date
status: Vacation request status
employeeId: Employee ID
statusChangedAt: Status change timestamp
statusChangedBy: User ID who changed status

Sort Structure:

[
  {
    "field": "field_name",
    "direction": "asc|desc"
  }
]

Default Sort: dateFrom (desc)

fieldsToReturnstring[]

Comma-separated list of field names to include in response items. If not provided, all fields are returned.

Available Fields: id, dateFrom, dateTo, status, employeeId, statusChangedAt, statusChangedBy, reason

Responses

200

itemsVacationHistoryResponse[]required

Show properties

Array of VacationHistoryResponse

dateFromstringrequired

dateTostringrequired

employeeIdstringrequired

idstringrequired

reasonstring | nullrequired

statusstringrequired

Allowed:PendingApprovedRejected

statusChangedAtstring | nullrequired

statusChangedBystring | nullrequired

pagenumberrequired

pageSizenumberrequired

totalnumberrequired

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

404

Employee not found

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

pagequeryPage number (1-based)pageSizequeryNumber of items per pageviewIdqueryView identifier for saved grid configurationsfiltersqueryJSON string containing filter configuration. **Available Fields:** - **id** (string): Vacation request ID - **dateFrom** (date): Vacation start date - **dateTo** (date): Vacation end date - **status** (set): Vacation request status - **employeeId** (string): Employee ID - **statusChangedAt** (date): Status change timestamp - **statusChangedBy** (string): User ID who changed status **Filter Structure:** ```json [ { "type": "string|number|date|set|boolean|array|task_status|task_type", "fieldName": "field_name", "value": { "comparison": "comparison_type", "value": "filter_value" } } ] ``` **Group Filters (AND/OR Combinations):** ```json [ { "type": "group", "fieldName": "group0.18807479823070028", "value": { "type": "or", "filters": [ { "type": "string", "fieldName": "fileName", "value": { "comparison": "contain", "value": "aa" } }, { "type": "number", "fieldName": "rowCount", "value": { "comparison": ">=", "value": 33 } } ] } } ] ``` **Available Comparison Operators:** - **id** (string): Vacation request ID (string filter). Available comparisons: contain, not_contain, equal, starts_with, ends_with, is_empty, is_not_empty - **dateFrom** (date): Vacation start date (date filter). Available comparisons: equal, not_equal, >, <, >=, <=, between, lastMonth, thisMonth, is_empty, is_not_empty - **dateTo** (date): Vacation end date (date filter). Available comparisons: equal, not_equal, >, <, >=, <=, between, lastMonth, thisMonth, is_empty, is_not_empty - **status** (set): Vacation request status (set filter). Available comparisons: in, not_in, is_empty, is_not_empty - **employeeId** (string): Employee ID (string filter). Available comparisons: contain, not_contain, equal, starts_with, ends_with, is_empty, is_not_empty - **statusChangedAt** (date): Status change timestamp (date filter). Available comparisons: equal, not_equal, >, <, >=, <=, between, lastMonth, thisMonth, is_empty, is_not_empty - **statusChangedBy** (string): User ID who changed status (string filter). Available comparisons: contain, not_contain, equal, starts_with, ends_with, is_empty, is_not_empty **Note:** Use `quickSearch` parameter for simple text search instead of adding it to filters.sortqueryJSON array of sort objects. **Sortable Fields:** - **id**: Vacation request ID - **dateFrom**: Vacation start date - **dateTo**: Vacation end date - **status**: Vacation request status - **employeeId**: Employee ID - **statusChangedAt**: Status change timestamp - **statusChangedBy**: User ID who changed status **Sort Structure:** ```json [ { "field": "field_name", "direction": "asc|desc" } ] ``` **Default Sort:** dateFrom (desc)fieldsToReturnqueryComma-separated list of field names to include in response items. If not provided, all fields are returned. **Available Fields:** id, dateFrom, dateTo, status, employeeId, statusChangedAt, statusChangedBy, reason

Request

curl -X GET "https://leadtime.app/api/public/account/employee/vacations/history" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/account/employee/vacations/history", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/account/employee/vacations/history",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

{
  "items": [
    {
      "dateFrom": "2024-06-01T00:00:00.000Z",
      "dateTo": "2024-06-05T00:00:00.000Z",
      "employeeId": "123e4567-e89b-12d3-a456-426614174001",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "reason": "Family vacation",
      "status": "Approved",
      "statusChangedAt": "2024-06-02T10:30:00.000Z",
      "statusChangedBy": "John Doe"
    }
  ],
  "page": 1,
  "pageSize": 10,
  "total": 50
}