LeavePro

GET /org/leave

Leave that touches a date range. A booking that starts before the range or ends after it is included whole.

curl "https://api.myfolke.com/api/v1/org/leave?from=2026-10-01&to=2026-10-31" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Accept: application/json"

Options

Option	What it does
from, to	The range, as YYYY-MM-DD. Both default to your current leave year. Ask for a year or less at a time.
status	approved unless you say otherwise. Any of pending, approved, rejected and cancelled, separated by commas: status=approved,pending.
person	One team member’s leave, by their id.
page	Which page, from 1.

Response

{
  "data": [
    {
      "id": 4182,
      "person": { "id": 12, "name": "Priya Shah", "email": "priya@example.com" },
      "type": { "id": 1, "name": "Annual Leave" },
      "startDate": "2026-10-26",
      "endDate": "2026-10-30",
      "startsAfternoon": false,
      "endsMorning": false,
      "startTime": null,
      "endTime": null,
      "days": 5,
      "status": "approved",
      "closure": false,
      "requestedAt": "2026-09-14T10:26:00+01:00",
      "decidedAt": "2026-09-14T15:02:00+01:00"
    }
  ],
  "meta": {
    "from": "2026-10-01",
    "to": "2026-10-31",
    "page": 1,
    "lastPage": 1,
    "perPage": 100,
    "total": 1
  }
}

Leave comes 100 to a page, in date order. While page is less than lastPage, ask for the next one.

Fields

Field	What it is
person, type	Who it’s for and what kind of leave.
startDate, endDate	The first and last day, inclusive.
startsAfternoon	The first day starts at lunchtime. On a single day, that’s the afternoon off.
endsMorning	The last day ends at lunchtime. On a single day, that’s the morning off.
startTime, endTime	For part of one day, like "09:00" to "15:00". Otherwise null.
days	Working days it uses, worked out by your organisation’s rules when it was booked. Weekends, bank holidays and days the team member doesn’t work aren’t counted.
status	pending, approved, rejected or cancelled.
closure	true for leave Folke booked for everyone because of a closure that comes off allowance.
requestedAt	When it was asked for.
decidedAt	When it was approved, rejected or cancelled, or null while pending.

The notes team members write on a request aren’t included. They’re often about being unwell, and they stay between the team member and their manager.