Raw schema
{
"type": "object",
"properties": {
"destinations": {
"description": "Destination names or slugs: \"Caribbean\", \"norwegian-fjords\" (list_destinations has them all)",
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"departure_ports": {
"description": "Departure port names or slugs: \"Southampton\" (list_departure_ports has them all)",
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"cruise_lines": {
"description": "Cruise line names, slugs or short names: \"P&O\", \"fred-olsen\"",
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"ships": {
"description": "Ship names or slugs",
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"months": {
"description": "Departure months, YYYY-MM",
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$"
}
},
"date_from": {
"description": "Earliest departure date, YYYY-MM-DD",
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"date_to": {
"description": "Latest departure date, YYYY-MM-DD",
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"nights_min": {
"description": "Shortest length, in nights",
"type": "integer",
"minimum": 1,
"maximum": 365
},
"nights_max": {
"description": "Longest length, in nights",
"type": "integer",
"minimum": 1,
"maximum": 365
},
"max_price_gbp": {
"description": "Highest price per person, in pounds",
"type": "integer",
"minimum": 1,
"maximum": 1000000
},
"no_fly": {
"description": "true: only cruises leaving from a UK port",
"type": "boolean"
},
"round_trip": {
"description": "true: round trips only; false: one-way only",
"type": "boolean"
},
"kind": {
"description": "ocean or river cruises only",
"type": "string",
"enum": [
"ocean",
"river"
]
},
"sort": {
"description": "departure (default), price, price_per_night, nights (shortest first) or newest",
"type": "string",
"enum": [
"departure",
"price",
"price_per_night",
"nights",
"newest"
]
},
"query": {
"description": "Free text, read into the fields above: \"a week in the fjords from Southampton next June\". Structured fields win where both are given. Leave it out when paging.",
"type": "string",
"maxLength": 200
},
"cursor": {
"description": "next_cursor from the previous page. It holds only the page number, so send it with that page's applied_filters",
"type": "string",
"maxLength": 64
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}