action ptv_disruptions_get_disruption_by_id {
  label: "View a specific disruption"
  provider: ptv
  method: GET
  path: "/v3/disruptions/{disruption_id}"
  encoding: json
  input: {
    type: "object"
    properties: {
      devid: {
        type: "string"
      }
      disruption_id: {
        type: "integer"
        format: "int64"
      }
      signature: {
        type: "string"
      }
      token: {
        type: "string"
      }
    }
    required: ["disruption_id"]
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      disruption: {
        type: "object"
        properties: {
          colour: {
            type: "string"
          }
          description: {
            type: "string"
            description: "Description of the disruption"
          }
          display_on_board: {
            type: "boolean"
          }
          display_status: {
            type: "boolean"
          }
          disruption_id: {
            type: "integer"
            format: "int64"
            description: "Disruption information identifier"
          }
          disruption_status: {
            type: "string"
            description: "Status of the disruption (e.g. \"Planned\", \"Current\")"
          }
          disruption_type: {
            type: "string"
            description: "Type of disruption"
          }
          from_date: {
            type: "string"
            format: "date-time"
            description: "Date and time at which disruption begins, in ISO 8601 UTC format"
          }
          last_updated: {
            type: "string"
            format: "date-time"
            description: "Date and time disruption information was last updated by PTV, in ISO 8601 UTC format"
          }
          published_on: {
            type: "string"
            format: "date-time"
            description: "Date and time disruption information is published on PTV website, in ISO 8601 UTC format"
          }
          routes: {
            type: "array"
            description: "Route relevant to a disruption (if applicable)"
            items: {
              type: "object"
              properties: {
                direction: {
                  type: "object"
                  properties: {
                    direction_id: {
                      type: "integer"
                      format: "int32"
                      description: "Direction of travel identifier"
                    }
                    direction_name: {
                      type: "string"
                      description: "Name of direction of travel"
                    }
                    route_direction_id: {
                      type: "integer"
                      format: "int32"
                      description: "Route and direction of travel combination identifier"
                    }
                    service_time: {
                      type: "string"
                      description: "Time of service to which disruption applies, in 24 hour clock format (HH:MM:SS) AEDT/AEST; returns null if disruption applies to multiple (or no) services"
                    }
                  }
                }
                route_gtfs_id: {
                  type: "string"
                  description: "GTFS Identifer of the route"
                }
                route_id: {
                  type: "integer"
                  format: "int32"
                  description: "Route identifier"
                }
                route_name: {
                  type: "string"
                  description: "Name of route"
                }
                route_number: {
                  type: "string"
                  description: "Route number presented to public (i.e. not route_id)"
                }
                route_type: {
                  type: "integer"
                  format: "int32"
                  description: "Transport mode identifier"
                }
              }
            }
          }
          stops: {
            type: "array"
            description: "Stop relevant to a disruption (if applicable)"
            items: {
              type: "object"
              properties: {
                stop_id: {
                  type: "integer"
                  format: "int32"
                }
                stop_name: {
                  type: "string"
                }
              }
            }
          }
          title: {
            type: "string"
            description: "Headline title summarising disruption information"
          }
          to_date: {
            type: "string"
            format: "date-time"
            description: "Date and time at which disruption ends, in ISO 8601 UTC format (returns null if unknown)"
          }
          url: {
            type: "string"
            description: "URL of relevant article on PTV website"
          }
        }
      }
      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"
          }
        }
      }
    }
  }
}