# roamgap — Smart Holiday Optimizer

Given a country and a PTO budget, find the calendar trips that maximise continuous time off per PTO day spent.

## What it does

You tell roamgap a country and how many days of paid time off you have. It returns
the calendar trips that get you the most continuous time off per PTO day spent.

A Tuesday public holiday combined with the surrounding weekends can give a 5-day
break for just 2 days of PTO. The optimizer surfaces these opportunities
automatically, ranked by efficiency.

## How to use the API

```http
POST https://roamgap.ike.work/api/trip
content-type: application/json

{
  "country": "DE",
  "year": 2026,
  "ptoBudget": 10
}
```

The full contract is at `https://roamgap.ike.work/api/openapi.yaml`. JSON Schemas for every
entity are listed at `https://roamgap.ike.work/api/schemas`.

## For AI agents

- Index: `https://roamgap.ike.work/llms.txt`
- Full doc dump: `https://roamgap.ike.work/llms-full.txt`
- Discovery: `https://roamgap.ike.work/.well-known/ai-content.json`
- Every content URL has a `.md` twin — append `.md` to read it as plain text.