Skip to main content
Use leave requests when you need workflow details about submitted, approved, declined, or cancelled time-off requests. A worker can have more than one leave request for the same Leave over time.

​
Attributes

​
id
string
Unique identifier for the leave request, for example lvr_6r3wLwX44s0Ak0bDkP5n2r7Q.
​
status
string
Current request status. One of requested, approved, declined, or cancelled.
​
leave
object
Summary of the leave attached to this request.
​
created
string
ISO 8601 timestamp of when the leave request was created.
​
updated
string
ISO 8601 timestamp of the most recent update to this leave request.
{
  "id": "lvr_6r3wLwX44s0Ak0bDkP5n2r7Q",
  "status": "requested",
  "leave": {
    "id": "lv_1HPCXADYAhh5k1NMU0r1WUqs",
    "type": "vacation",
    "worker": "wr_CgcLakmx4guire",
    "starts": "2026-04-14",
    "ends": "2026-04-16",
    "days": 2.5,
    "hours": 20,
    "schedule": {
      "2026-04-14": 8,
      "2026-04-15": 8,
      "2026-04-16": 4
    },
    "note": "Annual vacation"
  },
  "created": "2026-03-10T18:42:11Z",
  "updated": "2026-03-10T18:42:11Z"
}