redbus.in

{
  "type": "object",
  "properties": {
    "source": {
      "type": "string",
      "description": "Source city name (e.g., \"Bangalore\", \"Singapore\", \"Kuala Lumpur\", \"Phnom Penh\")"
    },
    "destination": {
      "type": "string",
      "description": "Destination city name (e.g., \"Chennai\", \"Johor Bahru\", \"Penang\", \"Siem Reap\")"
    },
    "date": {
      "type": "string",
      "description": "Travel date. Use ISO YYYY-MM-DD with the correct calendar year (same as the user's \"today\"). Accepts natural language (\"today\", \"tomorrow\") or \"in N days\". If the year is wrong/outdated, it is corrected to this year or next."
    },
    "filters": {
      "type": "object",
      "description": "Optional filters to pre-apply on the results page. Include every criterion the user asked for (e.g. AC + SLEEPER + Volvo) in one object.",
      "properties": {
        "acType": {
          "type": "string",
          "enum": [
            "AC",
            "NON_AC"
          ],
          "description": "AC or Non-AC bus preference"
        },
        "seatType": {
          "type": "string",
          "enum": [
            "SEATER",
            "SLEEPER",
            "SEMI_SLEEPER"
          ],
          "description": "Seat type preference"
        },
        "departureTime": {
          "type": "string",
          "enum": [
            "MORNING",
            "AFTERNOON",
            "EVENING",
            "NIGHT"
          ],
          "description": "Preferred departure time slot: MORNING (6AM-12PM), AFTERNOON (12PM-6PM), EVENING (6PM-12AM), NIGHT (12AM-6AM)"
        },
        "arrivalTime": {
          "type": "string",
          "enum": [
            "MORNING",
            "AFTERNOON",
            "EVENING",
            "NIGHT"
          ],
          "description": "Preferred arrival time slot: MORNING (6AM-12PM), AFTERNOON (12PM-6PM), EVENING (6PM-12AM), NIGHT (12AM-6AM)"
        },
        "operatorOrBusBrandKeyword": {
          "type": "string",
          "description": "Operator or bus brand mentioned by the user (e.g. \"Volvo\", \"Benz\"). Resolved on the results page against live filter data."
        }
      }
    },
    "runAfterSearchResultsLoad": {
      "type": "object",
      "description": "Optional. Same fields as runSrpBookingFlow (openBus, selectSeats, continueToBoardingPoints, applyFilters, waitForSearchResultsMs). Stored for the results page to execute after tuples load."
    }
  },
  "required": [
    "source",
    "destination",
    "date"
  ]
}