journey.com

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text destination or property name, e.g. `Aspen, Colorado`, `castle hill inn`, or `Nihi Sumba`."
    },
    "place_id": {
      "type": "string",
      "description": "Google place id from a previous suggestion."
    },
    "property_id": {
      "type": "integer",
      "description": "Numeric Journey property id."
    },
    "bounds": {
      "type": "object",
      "additionalProperties": false,
      "description": "Explicit map viewport. Ignored when `query` or `place_id` is supplied.",
      "properties": {
        "north": {
          "type": "number"
        },
        "south": {
          "type": "number"
        },
        "east": {
          "type": "number"
        },
        "west": {
          "type": "number"
        }
      },
      "required": [
        "north",
        "south",
        "east",
        "west"
      ]
    },
    "check_in": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-in date, YYYY-MM-DD."
    },
    "check_out": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-out date, YYYY-MM-DD."
    },
    "flexible_dates": {
      "type": "boolean",
      "default": true,
      "description": "When fewer than three stays are available on the first page, check nearby dates ±1 day and return separately labelled alternatives. Set false for strictly fixed dates. Never silently changes the requested trip."
    },
    "adults": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Adults, default 2."
    },
    "children": {
      "type": "integer",
      "minimum": 0,
      "maximum": 20,
      "description": "Children, default 0."
    },
    "child_age": {
      "type": "integer",
      "minimum": 0,
      "maximum": 17,
      "description": "Age in years for a single child (e.g. 5). Prefer `child_ages` for more than one."
    },
    "child_ages": {
      "type": "array",
      "description": "Ages in years for each child, e.g. `[5]`. Flows through search, pricing, availability occupancy, and is echoed on the result. Booking URLs use the site's `children` count.",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 17
      },
      "maxItems": 20
    },
    "property_types": {
      "type": "array",
      "description": "Filter by stay type.",
      "items": {
        "type": "string",
        "enum": [
          "hotel",
          "residence",
          "unique"
        ]
      }
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Results per page, default 12."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Result offset for paging."
    }
  }
}