Use leave policies when you need to understand the rules that generate leave entitlements and
accrual transactions for a worker.
Attributes
Unique identifier for the leave policy, for example lvp_Xk9mPq2vR8tn3e.
Human-readable policy name.
Plain-language explanation of the policy’s legal or company basis.
Leave type the policy applies to, for example vacation or sick_time_off.
Whether the policy sets the base entitlement or adds on top of it. One of set or add.
Unit used for all policy quantities. One of days or hours.
Lifecycle state for the policy. One of draft, active, or archived.
Workspace that owns the policy. Returns null for platform-managed policies.
JSON Logic expression that determines which workers match this policy. Returns null when the
policy must be assigned manually.
Period definition used to reset the balance window.
Month the leave period starts when the policy uses a fixed annual reset.
Day of month the leave period starts when the policy uses a fixed annual reset.
Worker date source used for anniversary-based periods. Currently starts.
Accrual rule for the policy.
Amount granted per accrual period when the policy does not use tiers.
Rate denominator. One of year, month, pay_period, or hour.
Frequency used to create accrual transactions.
Hour ratio when per is hour, for example 30 for one hour per 30 hours worked.
Waiting period before accrual begins.
Tenure-based accrual tiers.
Carryover rule. Returns null for use-it-or-lose-it policies.
Minimum and maximum balance bounds for the policy.
Per-period usage limits. Returns null when there is no additional usage cap.
Termination payout rule for unused balance.
ISO 8601 timestamp of when the policy was created.
ISO 8601 timestamp of the most recent update to the policy.
{
"id": "lvp_Xk9mPq2vR8tn3e",
"name": "France — Paid Vacation",
"description": "French labor law mandates 25 business days of paid vacation per year.",
"type": "vacation",
"effect": "set",
"unit": "days",
"status": "active",
"workspace": null,
"applies": {
"==": [{ "var": "worker.country" }, "FR"]
},
"period": {
"month": 6,
"day": 1
},
"accrual": {
"amount": 25,
"per": "year",
"credit": "month",
"after": null
},
"carryover": {
"max": 5,
"expires": null
},
"balance": {
"min": 0,
"max": null
},
"usage": null,
"payout": {
"termination": "required"
},
"created": "2026-03-01T00:00:00Z",
"updated": "2026-03-01T00:00:00Z"
}
