PakBus

Lists the Pakistani cities with PakBus routes, the number of routes in each and the city name in Urdu.

{
  "type": "object",
  "properties": {}
}

Finds bus stops, stations and the places around them by name, in one city or in every city. Accepts common English spellings of Pakistani place names, such as Faizabad or Faiz Abad. Returns the place_id and city each other tool needs. When nothing matches in a city, it lists the stops in that city served by the most routes.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Place name in English letters, such as Liberty Chowk or Saddar."
    },
    "city": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Search one city network. Leave out to search every city."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Plans bus and metro journeys between two places in one city network. Returns the first journey leaving at or after the departure time as numbered steps with boarding stops, changes, walking, times and fare, a link that opens it in PakBus, and up to two later departures on one line. Apps that show interactive views also get a map of the journey.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "City network from find_places or list_cities, such as Lahore, Attock or Rawalpindi."
    },
    "from": {
      "type": "string",
      "pattern": "^[a-z0-9]{1,16}$",
      "description": "place_id of the start, from find_places."
    },
    "to": {
      "type": "string",
      "pattern": "^[a-z0-9]{1,16}$",
      "description": "place_id of the destination, from find_places."
    },
    "depart": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
      "description": "Departure date and time in Pakistan local time, as YYYY-MM-DDTHH:MM. Leave out to leave now. Search again with a later time for later journeys."
    },
    "max_changes": {
      "type": "integer",
      "minimum": 0,
      "maximum": 5,
      "description": "Most changes between buses, 0 for direct journeys only. Defaults to 2. When none are found within the limit, journeys with up to 5 changes are returned."
    }
  },
  "required": [
    "city",
    "from",
    "to"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lists the next three departures today from a place for each route and direction that boards there, soonest first, with the minutes until each, the last bus of the day, the fare and the stops each direction serves after the place.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "City network from find_places or list_cities, such as Lahore, Attock or Rawalpindi."
    },
    "place": {
      "type": "string",
      "pattern": "^[a-z0-9]{1,16}$",
      "description": "place_id from find_places."
    }
  },
  "required": [
    "city",
    "place"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lists current and announced service changes in a city network, such as closed stations, skipped stops or diversions, for every route or for one route by code, name or service. plan_journey, place_departures and route_details already include the changes on the routes they use.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "City network from find_places or list_cities, such as Lahore, Attock or Rawalpindi."
    },
    "route": {
      "type": "string",
      "maxLength": 80,
      "description": "Route code, name or service. Leave out for every change in the city."
    }
  },
  "required": [
    "city"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lists a city's routes with fares, or shows one route: its stops in order in each direction, its fare and the day’s departure times from the first stop. Finds a route by code such as EV5701, by name such as Orange Line, or by service such as Green Electric Bus.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "City network from find_places or list_cities, such as Lahore, Attock or Rawalpindi."
    },
    "route": {
      "type": "string",
      "maxLength": 80,
      "description": "Route code, name or service. Leave out to list every route in the city."
    }
  },
  "required": [
    "city"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}