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"
        }
      ]
    }
  ]
}

View the raw file: examples/boat-rental.json →

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"
        }
      ]
    }
  ]
}

View the raw file: examples/course.json →

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": []
        }
      }
    }
  ]
}

View the raw file: examples/schedule.json →

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.