---
updatedAt: 2025-09-08T20:16:11.000Z
agentTools:
  projectIndex: https://platform.humanity.com/llms.txt
---

# GET Leaves

/leaves
Permission level: 7

Retrieves a list of vacations. It will return first 100 by default with parameters page limit you can manipulate the result set.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "default",
    "version": "2.0"
  },
  "servers": [
    {
      "url": "https://www.humanity.com/api/v2"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "x-default": "",
        "type": "apiKey",
        "name": "access_token",
        "in": "query"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/leaves?access_token=xxxxxxx": {
      "get": {
        "summary": "GET Leaves",
        "description": "/leaves\nPermission level: 7",
        "operationId": "get-leaves",
        "parameters": [
          {
            "name": "start_date",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "end_date",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "mode",
            "in": "query",
            "description": "enum[manage, requested, upcoming, all_requested]",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "user_id",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "sortby",
            "in": "query",
            "description": "enum[employee_start, vacation_start]",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "deleted",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "force_user_timezone",
            "in": "query",
            "description": "enum[0, 1]",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "location",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "position",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Number of pages - default is 1 with 100 leaves max",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Number of leaves per page",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"status\": 1,\n  \"data\": [\n    {\n      \"id\": \"2621938\",\n      \"user\": \"2744093\",\n      \"store\": \"251300\",\n      \"date\": \"1472140109\",\n      \"requested_on\": {\n        \"id\": 2675,\n        \"month\": 8,\n        \"day\": 25,\n        \"wday\": 4,\n        \"year\": 2016,\n        \"weekday\": \"Thu\",\n        \"mname\": \"Aug\",\n        \"week\": 34,\n        \"dayid\": 5,\n        \"timeid\": 1,\n        \"timeid_exact\": 1,\n        \"formatted\": \"Aug 25, 2016\",\n        \"time\": \"12:00am\",\n        \"timestamp\": 1472076000,\n        \"hours\": 0,\n        \"minutes\": 0,\n        \"seconds\": 0,\n        \"date\": \"2016-08-25 00:00:00\",\n        \"day_of_year\": \"237\",\n        \"week_adjusted\": 34,\n        \"sp_wday\": 5\n      },\n      \"approved_on\": \"1472140112\",\n      \"status\": \"1\",\n      \"admin\": \"2736727\",\n      \"comments\": \"Requesting leave for vacation\",\n      \"notes\": \"\",\n      \"start_day\": {\n        \"id\": 2682,\n        \"month\": 9,\n        \"day\": 1,\n        \"wday\": 4,\n        \"year\": 2016,\n        \"weekday\": \"Thu\",\n        \"mname\": \"Sep\",\n        \"week\": 35,\n        \"dayid\": 5,\n        \"timeid\": 1,\n        \"timeid_exact\": 1,\n        \"formatted\": \"Sep 1, 2016\",\n        \"time\": \"12:00am\",\n        \"timestamp\": 1472680800,\n        \"hours\": 0,\n        \"minutes\": 0,\n        \"seconds\": 0,\n        \"date\": \"2016-09-01 00:00:00\",\n        \"day_of_year\": \"244\",\n        \"week_adjusted\": 35,\n        \"sp_wday\": 5\n      },\n      \"end_day\": {\n        \"id\": 2693,\n        \"month\": 9,\n        \"day\": 12,\n        \"wday\": 1,\n        \"year\": 2016,\n        \"weekday\": \"Mon\",\n        \"mname\": \"Sep\",\n        \"week\": 37,\n        \"dayid\": 2,\n        \"timeid\": 1,\n        \"timeid_exact\": 1,\n        \"formatted\": \"Sep 12, 2016\",\n        \"time\": \"12:00am\",\n        \"timestamp\": 1473631200,\n        \"hours\": 0,\n        \"minutes\": 0,\n        \"seconds\": 0,\n        \"date\": \"2016-09-12 00:00:00\",\n        \"day_of_year\": \"255\",\n        \"week_adjusted\": 37,\n        \"sp_wday\": 2\n      },\n      \"requested_on_timestamp\": \"2016-08-25 00:00:00\",\n      \"start_timestamp\": \"2016-09-01 00:00:00\",\n      \"end_timestamp\": \"2016-09-13 00:00:00\",\n      \"leave_type\": \"0\",\n      \"approved_by\": \"2736727\",\n      \"rejected_by\": \"0\",\n      \"rejected_on\": \"0\",\n      \"reason\": \"\",\n      \"employee_name\": \"Frederick Braxton\",\n      \"leave_type_name\": null,\n      \"employee\": \"2744093\",\n      \"until\": {\n        \"id\": 2694,\n        \"month\": 9,\n        \"day\": 13,\n        \"wday\": 2,\n        \"year\": 2016,\n        \"weekday\": \"Tue\",\n        \"mname\": \"Sep\",\n        \"week\": 37,\n        \"dayid\": 3,\n        \"timeid\": 1,\n        \"timeid_exact\": 1,\n        \"formatted\": \"Sep 13, 2016\",\n        \"time\": \"12:00am\",\n        \"timestamp\": 1473717600,\n        \"hours\": 0,\n        \"minutes\": 0,\n        \"seconds\": 0,\n        \"date\": \"2016-09-13 00:00:00\",\n        \"day_of_year\": \"256\",\n        \"week_adjusted\": 37,\n        \"sp_wday\": 3\n      },\n      \"total_days\": 12,\n      \"length\": 12,\n      \"total_days_alotted\": 8\n    }\n  ],\n  \"token\": \"xxxxxxx\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "integer",
                      "example": 1,
                      "default": 0
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "example": "2621938"
                          },
                          "user": {
                            "type": "string",
                            "example": "2744093"
                          },
                          "store": {
                            "type": "string",
                            "example": "251300"
                          },
                          "date": {
                            "type": "string",
                            "example": "1472140109"
                          },
                          "requested_on": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "integer",
                                "example": 2675,
                                "default": 0
                              },
                              "month": {
                                "type": "integer",
                                "example": 8,
                                "default": 0
                              },
                              "day": {
                                "type": "integer",
                                "example": 25,
                                "default": 0
                              },
                              "wday": {
                                "type": "integer",
                                "example": 4,
                                "default": 0
                              },
                              "year": {
                                "type": "integer",
                                "example": 2016,
                                "default": 0
                              },
                              "weekday": {
                                "type": "string",
                                "example": "Thu"
                              },
                              "mname": {
                                "type": "string",
                                "example": "Aug"
                              },
                              "week": {
                                "type": "integer",
                                "example": 34,
                                "default": 0
                              },
                              "dayid": {
                                "type": "integer",
                                "example": 5,
                                "default": 0
                              },
                              "timeid": {
                                "type": "integer",
                                "example": 1,
                                "default": 0
                              },
                              "timeid_exact": {
                                "type": "integer",
                                "example": 1,
                                "default": 0
                              },
                              "formatted": {
                                "type": "string",
                                "example": "Aug 25, 2016"
                              },
                              "time": {
                                "type": "string",
                                "example": "12:00am"
                              },
                              "timestamp": {
                                "type": "integer",
                                "example": 1472076000,
                                "default": 0
                              },
                              "hours": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              },
                              "minutes": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              },
                              "seconds": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              },
                              "date": {
                                "type": "string",
                                "example": "2016-08-25 00:00:00"
                              },
                              "day_of_year": {
                                "type": "string",
                                "example": "237"
                              },
                              "week_adjusted": {
                                "type": "integer",
                                "example": 34,
                                "default": 0
                              },
                              "sp_wday": {
                                "type": "integer",
                                "example": 5,
                                "default": 0
                              }
                            }
                          },
                          "approved_on": {
                            "type": "string",
                            "example": "1472140112"
                          },
                          "status": {
                            "type": "string",
                            "example": "1"
                          },
                          "admin": {
                            "type": "string",
                            "example": "2736727"
                          },
                          "comments": {
                            "type": "string",
                            "example": "Requesting leave for vacation"
                          },
                          "notes": {
                            "type": "string",
                            "example": ""
                          },
                          "start_day": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "integer",
                                "example": 2682,
                                "default": 0
                              },
                              "month": {
                                "type": "integer",
                                "example": 9,
                                "default": 0
                              },
                              "day": {
                                "type": "integer",
                                "example": 1,
                                "default": 0
                              },
                              "wday": {
                                "type": "integer",
                                "example": 4,
                                "default": 0
                              },
                              "year": {
                                "type": "integer",
                                "example": 2016,
                                "default": 0
                              },
                              "weekday": {
                                "type": "string",
                                "example": "Thu"
                              },
                              "mname": {
                                "type": "string",
                                "example": "Sep"
                              },
                              "week": {
                                "type": "integer",
                                "example": 35,
                                "default": 0
                              },
                              "dayid": {
                                "type": "integer",
                                "example": 5,
                                "default": 0
                              },
                              "timeid": {
                                "type": "integer",
                                "example": 1,
                                "default": 0
                              },
                              "timeid_exact": {
                                "type": "integer",
                                "example": 1,
                                "default": 0
                              },
                              "formatted": {
                                "type": "string",
                                "example": "Sep 1, 2016"
                              },
                              "time": {
                                "type": "string",
                                "example": "12:00am"
                              },
                              "timestamp": {
                                "type": "integer",
                                "example": 1472680800,
                                "default": 0
                              },
                              "hours": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              },
                              "minutes": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              },
                              "seconds": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              },
                              "date": {
                                "type": "string",
                                "example": "2016-09-01 00:00:00"
                              },
                              "day_of_year": {
                                "type": "string",
                                "example": "244"
                              },
                              "week_adjusted": {
                                "type": "integer",
                                "example": 35,
                                "default": 0
                              },
                              "sp_wday": {
                                "type": "integer",
                                "example": 5,
                                "default": 0
                              }
                            }
                          },
                          "end_day": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "integer",
                                "example": 2693,
                                "default": 0
                              },
                              "month": {
                                "type": "integer",
                                "example": 9,
                                "default": 0
                              },
                              "day": {
                                "type": "integer",
                                "example": 12,
                                "default": 0
                              },
                              "wday": {
                                "type": "integer",
                                "example": 1,
                                "default": 0
                              },
                              "year": {
                                "type": "integer",
                                "example": 2016,
                                "default": 0
                              },
                              "weekday": {
                                "type": "string",
                                "example": "Mon"
                              },
                              "mname": {
                                "type": "string",
                                "example": "Sep"
                              },
                              "week": {
                                "type": "integer",
                                "example": 37,
                                "default": 0
                              },
                              "dayid": {
                                "type": "integer",
                                "example": 2,
                                "default": 0
                              },
                              "timeid": {
                                "type": "integer",
                                "example": 1,
                                "default": 0
                              },
                              "timeid_exact": {
                                "type": "integer",
                                "example": 1,
                                "default": 0
                              },
                              "formatted": {
                                "type": "string",
                                "example": "Sep 12, 2016"
                              },
                              "time": {
                                "type": "string",
                                "example": "12:00am"
                              },
                              "timestamp": {
                                "type": "integer",
                                "example": 1473631200,
                                "default": 0
                              },
                              "hours": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              },
                              "minutes": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              },
                              "seconds": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              },
                              "date": {
                                "type": "string",
                                "example": "2016-09-12 00:00:00"
                              },
                              "day_of_year": {
                                "type": "string",
                                "example": "255"
                              },
                              "week_adjusted": {
                                "type": "integer",
                                "example": 37,
                                "default": 0
                              },
                              "sp_wday": {
                                "type": "integer",
                                "example": 2,
                                "default": 0
                              }
                            }
                          },
                          "requested_on_timestamp": {
                            "type": "string",
                            "example": "2016-08-25 00:00:00"
                          },
                          "start_timestamp": {
                            "type": "string",
                            "example": "2016-09-01 00:00:00"
                          },
                          "end_timestamp": {
                            "type": "string",
                            "example": "2016-09-13 00:00:00"
                          },
                          "leave_type": {
                            "type": "string",
                            "example": "0"
                          },
                          "approved_by": {
                            "type": "string",
                            "example": "2736727"
                          },
                          "rejected_by": {
                            "type": "string",
                            "example": "0"
                          },
                          "rejected_on": {
                            "type": "string",
                            "example": "0"
                          },
                          "reason": {
                            "type": "string",
                            "example": ""
                          },
                          "employee_name": {
                            "type": "string",
                            "example": "Frederick Braxton"
                          },
                          "leave_type_name": {},
                          "employee": {
                            "type": "string",
                            "example": "2744093"
                          },
                          "until": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "integer",
                                "example": 2694,
                                "default": 0
                              },
                              "month": {
                                "type": "integer",
                                "example": 9,
                                "default": 0
                              },
                              "day": {
                                "type": "integer",
                                "example": 13,
                                "default": 0
                              },
                              "wday": {
                                "type": "integer",
                                "example": 2,
                                "default": 0
                              },
                              "year": {
                                "type": "integer",
                                "example": 2016,
                                "default": 0
                              },
                              "weekday": {
                                "type": "string",
                                "example": "Tue"
                              },
                              "mname": {
                                "type": "string",
                                "example": "Sep"
                              },
                              "week": {
                                "type": "integer",
                                "example": 37,
                                "default": 0
                              },
                              "dayid": {
                                "type": "integer",
                                "example": 3,
                                "default": 0
                              },
                              "timeid": {
                                "type": "integer",
                                "example": 1,
                                "default": 0
                              },
                              "timeid_exact": {
                                "type": "integer",
                                "example": 1,
                                "default": 0
                              },
                              "formatted": {
                                "type": "string",
                                "example": "Sep 13, 2016"
                              },
                              "time": {
                                "type": "string",
                                "example": "12:00am"
                              },
                              "timestamp": {
                                "type": "integer",
                                "example": 1473717600,
                                "default": 0
                              },
                              "hours": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              },
                              "minutes": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              },
                              "seconds": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              },
                              "date": {
                                "type": "string",
                                "example": "2016-09-13 00:00:00"
                              },
                              "day_of_year": {
                                "type": "string",
                                "example": "256"
                              },
                              "week_adjusted": {
                                "type": "integer",
                                "example": 37,
                                "default": 0
                              },
                              "sp_wday": {
                                "type": "integer",
                                "example": 3,
                                "default": 0
                              }
                            }
                          },
                          "total_days": {
                            "type": "integer",
                            "example": 12,
                            "default": 0
                          },
                          "length": {
                            "type": "integer",
                            "example": 12,
                            "default": 0
                          },
                          "total_days_alotted": {
                            "type": "integer",
                            "example": 8,
                            "default": 0
                          }
                        }
                      }
                    },
                    "token": {
                      "type": "string",
                      "example": "xxxxxxx"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false,
        "x-readme": {
          "code-samples": [
            {
              "language": "text",
              "code": "https://www.humanity.com/api/v2/leaves?access_token=xxxxxxx"
            }
          ],
          "samples-languages": [
            "text"
          ]
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```