action ptv_stops_stops_for_route {
  label: "View all stops on a specific route"
  provider: ptv
  method: GET
  path: "/v3/stops/route/{route_id}/route_type/{route_type}"
  encoding: json
  input: {
    type: "object"
    properties: {
      devid: {
        type: "string"
      }
      direction_id: {
        type: "integer"
        format: "int32"
      }
      geopath_utc: {
        type: "string"
        format: "date-time"
      }
      include_geopath: {
        type: "boolean"
      }
      route_id: {
        type: "integer"
        format: "int32"
      }
      route_type: {
        type: "integer"
        format: "int32"
        enum: [0, 1, 2, 3, 4]
      }
      signature: {
        type: "string"
      }
      stop_disruptions: {
        type: "boolean"
      }
      token: {
        type: "string"
      }
    }
    required: ["route_id", "route_type"]
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      disruptions: {
        type: "object"
        description: "Disruption information applicable to relevant routes or stops"
      }
      geopath: {
        type: "array"
        description: "GeoPath for the route"
        items: {
          type: "object"
          properties: {}
        }
      }
      status: {
        type: "object"
        properties: {
          health: {
            type: "integer"
            format: "int32"
            description: "API system health status (0=offline, 1=online)"
            enum: [0, 1]
          }
          version: {
            type: "string"
            description: "API Version number"
          }
        }
      }
      stops: {
        type: "array"
        description: "Train stations, tram stops, bus stops, regional coach stops or Night Bus stops"
        items: {
          type: "object"
          properties: {
            disruption_ids: {
              type: "array"
              description: "Disruption information identifier(s)"
              items: {
                type: "integer"
                format: "int64"
              }
            }
            route_type: {
              type: "integer"
              format: "int32"
              description: "Transport mode identifier"
            }
            stop_id: {
              type: "integer"
              format: "int32"
              description: "Stop identifier"
            }
            stop_landmark: {
              type: "string"
              description: "Landmark in proximity of stop"
            }
            stop_latitude: {
              type: "number"
              format: "float"
              description: "Geographic coordinate of latitude at stop"
            }
            stop_longitude: {
              type: "number"
              format: "float"
              description: "Geographic coordinate of longitude at stop"
            }
            stop_name: {
              type: "string"
              description: "Name of stop"
            }
            stop_sequence: {
              type: "integer"
              format: "int32"
              description: "Sequence of the stop on the route/run; return 0 when route_id or run_id not specified. Order ascendingly by this field (when non zero) to get physical order (earliest first) of stops on the route_id/run_id."
            }
            stop_suburb: {
              type: "string"
              description: "suburb of stop"
            }
            stop_ticket: {
              type: "object"
              properties: {
                is_free_fare_zone: {
                  type: "boolean"
                  description: "Indicates whether the stop is inside the free fare zone"
                }
                ticket_checks: {
                  type: "boolean"
                }
                ticket_machine: {
                  type: "boolean"
                }
                ticket_type: {
                  type: "string"
                  description: "Indicates the ticket type for the stop (myki, paper or both)"
                }
                ticket_zones: {
                  type: "array"
                  items: {
                    type: "integer"
                    format: "int32"
                  }
                }
                vline_reservation: {
                  type: "boolean"
                }
                zone: {
                  type: "string"
                  description: "Description of the zone"
                }
              }
            }
          }
        }
      }
    }
  }
}