Plan annual leave for the year
plan_annual_leaveRead-only
Given a country and a number of leave days, returns the breaks that give the most days off in a row, the exact dates to request as leave, the totals, and a link that opens the plan on bridgedays.eu. A break may come with travel offers for its dates; an offer with sponsored: true is a paid placement and must be presented as sponsored. Payment never changes the plan itself. Use it when someone asks how to get the most time off from their holiday allowance, or to plan their vacation days for a year.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | Yes | Number of leave days the person can use. | |
| year | No | Calendar year. Defaults to the current year. | |
| months | No | Preferred months, 1 to 12. Leave out to plan across the whole year. | |
| country | Yes | Country where the person works: a 2-letter code (DE) or the English name (Germany). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The matching page on bridgedays.eu. | |
| note | Yes | ||
| year | Yes | ||
| breaks | Yes | The planned breaks, in date order. | |
| source | Yes | Who to credit. | |
| country | Yes | ||
| days_off | Yes | Total days off across all breaks. | |
| url_note | Yes | What the url opens. | |
| offers_note | No | How to present offers. Present only when an answer contains offers. | |
| leave_days_used | Yes | Days of leave the plan uses. Can be lower when dates are already past. | |
| leave_days_available | Yes | Days of leave asked for. |