action threatjammer_get_source_and_timerange_info_v1_source_ip_source_range_time_ran {
  label: "Get the information of the source list given for a specific time range."
  description: "### What\nObtain the meta information of the source list and the time range given as arguments. A source list is a collection of resources combined together with other sources to create a dataset. A source list has some unique properties. The most relevant ones are the score and risk. The score is a number **between 0 and 99** describing the probability of the IP address being a malicious one, being **0** means that the IP address is not malicious and is not a threat. Being **99** means that the service behind the IP address is probably malicious an certainly a threat.\n\n The time ranges or lapse of time of each source are how the resources are stored according to their age. Each group by time range has a score and a risk.\n\n### Parameters\nThe endpoint accepts the following two parameters in the path:\n- ``source``: (Mandatory) The code name that identifies uniquely the source list in the platform. It must be composed of uppercase letters, numbers and underscores.\n- ``time_range``: (Mandatory) The code name that identifies uniquely the time ranges. Must be: 1H, 6H, 12H, 1D, 7D, 30D, 90D, 180D y 365D.\n\n### Result\nThe result is a JSON object with the following fields:\n- ``self``: the URI to individual source list and time range information.\n- ``source``: the URI to individual source list information.\n- ``items``: Number of elements in the source list in the time range given.\n- ``lapse``: The lapse of time or time range of the specific source list. Can be 1H, 6H, 12H, 1D, 7D, 30D, 90D, 180D or 365D.\n- ``score``: The score found in the source list time range. Is in the range 0-99.\n- ``risk``: The human readable risk score found in the source list time range. Can be UNKNOWN, LOW, MEDIUM or HIGH.\n- ``updated_at``: The UNIX timestamp in milliseconds of last update of the source list.\n\n### Errors\n- a `404 Not Found` error if the source list code name was not found.\n- a `404 Not Found` error if the time range was not found.\n- a `422 Unprocessable Entity` error if source list code name or time ranges does not follow the naming convention.\n\nIt will return the API Global errors described in the API description."
  provider: threatjammer
  method: GET
  path: "/v1/source/ip/{source}/range/{time_range}"
  encoding: json
  input: {
    type: "object"
    properties: {
      source: {
        type: "string"
      }
      time_range: {
        type: "string"
        enum: ["1H", "6H", "12H", "1D", "7D", "30D", "90D", "180D", "365D"]
      }
    }
    required: ["source", "time_range"]
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["items", "lapse", "risk", "score", "self", "source", "updated_at"]
    properties: {
      items: {
        type: "integer"
      }
      lapse: {
        type: "string"
        enum: ["1H", "6H", "12H", "1D", "7D", "30D", "90D", "180D", "365D"]
      }
      risk: {
        type: "string"
        enum: ["UNKNOWN", "LOW", "MEDIUM", "HIGH"]
      }
      score: {
        type: "integer"
      }
      self: {
        type: "string"
      }
      source: {
        type: "string"
      }
      updated_at: {
        type: "integer"
      }
    }
  }
}