Offers: a day charter
A boat that's rented out as full-day charters on specific dates, rather than recurring
time slots, gets published as a resource with one offer per date. Each
charter date has its own capacity and booking url.
{
"schema": "https://nauticopen.org/schema/0.1",
"provider": {
"id": "bootverhuur-example",
"type": "Organization",
"name": "Bootverhuur Example"
},
"resources": [
{
"id": "zeiljacht-dagcharter",
"type": "Boat",
"name": "Zeiljacht dagcharter",
"url": "https://example.com/zeiljacht-dagcharter",
"offers": [
{
"id": "zeiljacht-dagcharter-2026-09-26",
"price": 450,
"priceCurrency": "EUR",
"starts": "2026-09-26T09:00:00+02:00",
"ends": "2026-09-26T18:00:00+02:00",
"capacity": 8,
"remaining": 3,
"url": "https://example.com/boeken/zeiljacht-dagcharter-2026-09-26"
},
{
"id": "zeiljacht-dagcharter-2026-09-27",
"price": 450,
"priceCurrency": "EUR",
"starts": "2026-09-27T09:00:00+02:00",
"ends": "2026-09-27T18:00:00+02:00",
"capacity": 8,
"remaining": 8,
"url": "https://example.com/boeken/zeiljacht-dagcharter-2026-09-27"
}
]
}
]
}
Offers: a sailing course
A course that runs on specific dates gets published as a resource with one offer
per date. Each offer carries its own price, capacity and booking url.
{
"schema": "https://nauticopen.org/schema/0.1",
"provider": {
"id": "zeilschool-example",
"type": "Organization",
"name": "Zeilschool Example"
},
"resources": [
{
"id": "cwo-1",
"type": "Course",
"name": "CWO 1 Zeilen",
"url": "https://example.com/cwo-1",
"offers": [
{
"id": "cwo-1-2026-10-03",
"price": 295,
"priceCurrency": "EUR",
"starts": "2026-10-03T09:00:00+02:00",
"ends": "2026-10-04T17:00:00+02:00",
"capacity": 6,
"remaining": 2,
"url": "https://example.com/boeken/cwo-1-2026-10-03"
}
]
}
]
}
Schedule: recurring rental slots
A different boat from the same provider rents out the same two time slots every day. That
would need an offer per slot per day if published as offers. A
schedule keeps it compact instead: reusable options plus a
date-to-option-ids availability map.
{
"schema": "https://nauticopen.org/schema/0.1",
"provider": {
"id": "bootverhuur-example",
"type": "Organization",
"name": "Bootverhuur Example"
},
"resources": [
{
"id": "sloep-8-pers",
"type": "Boat",
"name": "Elektrische sloep 8 personen",
"url": "https://example.com/sloep",
"schedule": {
"options": [
{
"id": "morning",
"name": "Ochtend",
"starts": "09:00",
"ends": "13:00",
"price": 125,
"priceCurrency": "EUR"
},
{
"id": "afternoon",
"name": "Middag",
"starts": "14:00",
"ends": "18:00",
"price": 125,
"priceCurrency": "EUR"
}
],
"availability": {
"2026-09-20": ["morning", "afternoon"],
"2026-09-21": ["afternoon"],
"2026-09-22": []
}
}
}
]
}
Validating a feed
All three examples validate against the JSON Schema. Paste your own feed into the online validator for an instant check, or validate it yourself from the command line:
pip install jsonschema
python3 -c "
import json, jsonschema
schema = json.load(open('feed.schema.json'))
data = json.load(open('your-feed.json'))
jsonschema.Draft202012Validator(schema, format_checker=jsonschema.FormatChecker()).validate(data)
print('OK')
"
The schema itself is at schema/0.1/feed.schema.json, documented field by field in the specification.