List Leave Periods

Auth required

GET/v1/leave_periods/

All leave periods for the organization, sorted by start date descending. is_active indicates the currently active period — it is NOT a soft-delete flag. All periods are returned regardless of is_active. Offset pagination — default limit 50, max 100.

Parameters

pageoptionalinteger

Page number (1-based)

limitoptionalinteger

Items per page (max 100)

Credentials

X-APPLOYE-API-KEY

Stored in this browser tab only. Try It always sends your key; code samples show a YOUR_API_KEY placeholder until you reveal the key with the eye toggle.

curl --request GET \
  --url "https://api.apploye.com/v1/leave_periods/" \
  --header "accept: application/json" \
  --header "X-APPLOYE-API-KEY: YOUR_API_KEY"

# Optional parameters — append to the --url query string to include
#   ?page=1
#   &limit=50

Response

Paginated list of leave periods

{
  "count": 0,
  "next": "string",
  "previous": "string",
  "results": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "start_date": "2026-08-11",
      "end_date": "2026-08-11",
      "is_active": true,
      "created_at": "2026-08-11T02:31:37.681Z"
    }
  ]
}

List Leave Periods

Parameters#

Parameters