About · URL format
How to construct optimizer URLs
The shareable-URL contract for the trip finder and the annual planner. The Markdown twin at /about/url-format.md is the AI-readable form.
Paths
/year— annual planner, whole-year planning: five alternative year plans for your leave budget.
Parameters
Shared between both modes:
| Name | Type | Notes |
|---|---|---|
| country | ISO 3166-1 alpha-2 | Always uppercase. Required. |
| sub | ISO 3166-2 | Subdivision, e.g. DE-BY. Must match the country prefix. |
| year | 1900..2100 | Defaults to the current calendar year. |
| pto | integer | PTO budget (alias for ptoBudget). |
| months | 1..12 (repeated) | months=3&months=4 = March or April. |
| exclude | 1..7 (repeated) | ISO weekday — Mon=1, Sun=7. |
| block | YYYY-MM-DD:YYYY-MM-DD | Repeated, ascending by start date. |
Example
Germany 2026, 30 PTO days, max two-week trips, March or April only:
/year?country=DE&pto=30&max=14&year=2026&months=3&months=4