# Multi-country overlap — when can you all be off? — roamgap

> Find the calendar windows when you and your partner (or a group of up to 6) can
> all take time off together — optimised across each person's country and public
> holidays. One person can also align two countries' calendars (e.g. a remote
> worker living in one country, employed in another) to take the **best of both**.
> A **roamgap Plus** feature.

## What it does

You add 2–6 people. Each has their own country (and optional region), their own
annual leave (PTO) budget, and their own workweek. roamgap finds every calendar
span where **everyone** can be off within their own budget, and ranks them by the
**least total leave burned across the group** — longest break first within a tie.

A public holiday in one country is an ordinary working day in another, so the
engine optimises that asymmetry: a Monday that is Madaraka Day in Kenya costs a
Kenyan 0 leave but a German 1 day — the overlap surfaces exactly those windows.

**Best of both (dual-calendar).** A person can also observe extra calendars — a
remote worker living in Kenya but employed by a German company gets *both*
countries' public holidays off, so their leave is charged only on a day that is a
working day in neither. A single such person is itself a valid overlap query.

You also get a 12-month heatmap: each day is coloured **free for all** (everyone
already off), **some spend PTO**, or **everyone spends PTO**.

## Build a query by hand (for AI agents)

The page reads one `p=` parameter per person — `primary[+also…]:ptoDays`, where
each location is `country[-subdivision]` — plus a shared `year`:

```
https://roamgap.ike.work/overlap?p=KE:18&p=DE-BY:25&year=2026
https://roamgap.ike.work/overlap?p=KE+DE:25&year=2026
```

The first asks: a Kenyan with 18 leave days and a Bavarian with 25, in 2026. The
second is one person — a Kenyan resident who also observes Germany's holidays (best
of both). The first `p=` is "you"; 1–6 people are allowed (a lone person must add a
2nd country with `+`); `top=` caps the ranked list (default 10).

## Notes

- The interactive tool requires a (free) roamgap account and roamgap Plus.
- The ranked results + heatmap come from `POST /api/overlap`.
- A single person with just **one** country is the free trip finder + annual
  planner; add a 2nd country (`+`) to make it a best-of-both overlap.

## Source

- This page: https://roamgap.ike.work/overlap
- Annual planner: https://roamgap.ike.work/year