Example · all examples
Flight and hotel
This Roadbook represents the classic "flight + hotel" package with nothing else planned yet: two long-haul flights Paris ⇄ New York (outbound crossing six time zones, return overnight with endDate), PDF417 boarding passes with seats, a three-night hotel with check-in/out times and cancellation terms, a documents checklist (ESTA, insurance) and two free days left as placeholders to fill later.
⤓ Download flight-and-hotel.roadbook.json View raw JSON Validate Preview
What this example shows#
It is a good base for an AI assistant to complete ("now plan day 2 and day 3") — the skeleton, members, bookings and references are already there and valid. Prices are in USD via the trip-level currency.
Features demonstrated#
- Trip currency (USD), timezone
- flight items, endDate, timezones
- TransportDetails (terminal, timezone per point)
- Ticket pdf417 boarding passes, seat
- Booking checkin/checkout, cancellation, refs
- free items as placeholders
Manifest tags: flight long-haul timezone endDate pdf417 boarding pass hotel checkin checkout cancellation checklist USD — see examples/index.json.
Excerpt#
Abridged — the full file is the reference.
{
"days": [
{
"id": "d4",
"index": 4,
"date": "2026-12-07",
"title": "New York → Paris (overnight)",
"items": [
{
"id": "i9",
"time": "19:30",
"endTime": "08:45",
"endDate": "2026-12-08",
"title": "Flight JFK → CDG",
"type": "flight",
"status": "planned",
"timezone": "America/New_York",
"endTimezone": "Europe/Paris",
"bookingId": "b-flights",
"transport": {
"carrier": "Example Air",
"number": "EX 007",
"ref": "EXMPL2",
"from": {
"name": "New York JFK",
"terminal": "1",
"timezone": "America/New_York"
},
"to": {
"name": "Paris Charles de Gaulle (CDG)",
"terminal": "2E",
"timezone": "Europe/Paris"
}
},
"critical": "Overnight flight: lands the next morning, Paris time."
}
]
}
],
"bookings": [
{
"id": "b-hotel",
"type": "stay",
"status": "confirmed",
"title": "Midtown hotel — 3 nights",
"hotelStars": 3,
"dates": "Dec 4–7",
"checkin": "16:00",
"checkout": "11:00",
"breakfastIncluded": false,
"address": "W 44th St, New York, NY",
"price": 870,
"payment": {
"status": "onsite",
"note": "Card guarantee; city tax paid at check-out"
},
"refs": [
{
"label": "Confirmation",
"value": "HTL-EXAMPLE-9",
"sensitive": true
}
],
"cancellation": "Free until Dec 1."
}
]
}
Use it#
- As a reader test: load the file in your player or importer; it must open without error and unknown fields (if you add some) must survive a round-trip.
- As a writer reference: copy the shapes you need — the specification documents every field and the JSON Schema validates the structure.
- With an AI assistant: hand it the file URL as a shape reference ("produce a Roadbook like flight-and-hotel.roadbook.json for …"); then validate the output.