simfuse.app

{
  "properties": {
    "stops": {
      "description": "The trip, one entry per country, in travel order. 1 to 12 stops, e.g. [{\"country\":\"JP\",\"days\":7},{\"country\":\"KR\",\"days\":5}].",
      "minItems": 1,
      "maxItems": 12,
      "items": {
        "properties": {
          "country": {
            "description": "ISO 3166-1 alpha-2 country code, e.g. \"JP\" for Japan. Look one up with list-destinations rather than guessing. Each country may appear once: give one stop with the total days rather than two visits.",
            "minLength": 2,
            "maxLength": 2,
            "type": "string"
          },
          "days": {
            "description": "Days spent in that country, 1 to 365. Count the nights of the stay.",
            "minimum": 1,
            "maximum": 365,
            "type": "integer"
          },
          "usage": {
            "description": "Optional. How heavily data is used during this stop: \"light\" (about 300 MB a day, maps and messaging), \"regular\" (about 800 MB a day) or \"heavy\" (about 2 GB a day, video and hotspot). Overrides the trip-wide `usage` for this stop only.",
            "enum": [
              "light",
              "regular",
              "heavy"
            ],
            "type": "string"
          }
        },
        "type": "object",
        "required": [
          "country",
          "days"
        ]
      },
      "type": "array"
    },
    "usage": {
      "description": "Optional. Trip-wide data usage for stops that do not set their own: \"light\" (about 300 MB a day), \"regular\" (about 800 MB a day) or \"heavy\" (about 2 GB a day). Defaults to \"regular\".",
      "default": "regular",
      "enum": [
        "light",
        "regular",
        "heavy"
      ],
      "type": "string"
    },
    "start": {
      "description": "Optional. Departure date as YYYY-MM-DD, e.g. \"2026-04-18\". Only used to date the stops in the answer; it does not change prices. Defaults to today.",
      "minLength": 10,
      "maxLength": 10,
      "type": "string"
    },
    "currency": {
      "description": "Optional. ISO 4217 three-letter code every price is quoted in, e.g. \"USD\", \"EUR\", \"GBP\". Defaults to EUR. An unknown code falls back to EUR rather than failing.",
      "minLength": 3,
      "maxLength": 3,
      "type": "string"
    }
  },
  "type": "object",
  "required": [
    "stops"
  ]
}