action threatjammer_query_ip_address_network_information_v1_asn_ip_ip_address_get {
  label: "Get the IPv4 or IPv6 prefix of the IP address given."
  description: "### What\nObtain the IPv4 or IPv6 prefix and the Autonomous System information of the IP address passed as a parameter.\n\n### Parameters\nThe endpoint accepts only the following parameter in the path:\n- ``ip_address``: (Mandatory) The IPv4 or IPv6 address to be queried.\n\n### Result\nThe result is a JSON object with the following structure:\n- ``self``: the URI to individual IPv4 prefix.\n- ``asn``: the URI to query the full details of the ASN.\n- ``object_type``: the type of the prefix. The allowed values are: IPv4 or IPv6.\n- ``maintainer``: the information about the maintainer of this prefix in the registry.\n- ``description``: the description of the prefix as registered in the registry.\n- ``registry_date``: the date of registration of the prefix in the registry. The format is YYYY-MM-DD.\n- ``registry_status``: the URI of the status of the prefix as stored in the registry.\n- ``score``: The risk score of the prefix. It ranges from 0 to 99.\n- ``risk``: The risk of the prefix. The allowed values are: LOW, MEDIUM, HIGH. It's a human readable representation of the score.\n\n### Errors\nThe endpoint will return the following errors:\n- a `404 Not Found` error if the prefix information was not found.\n- a `422 Unprocessable Entity` error if the IP address is malformed.\n\nIt will also return the API Global errors described in the API description."
  provider: threatjammer
  method: GET
  path: "/v1/asn/ip/{ip_address}"
  encoding: json
  input: {
    type: "object"
    properties: {
      ip_address: {
        type: "string"
        format: "ipvanyaddress"
      }
    }
    required: ["ip_address"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "AutonomousSystemPrefixResponse class to return the information to the user"
    required: ["description", "mantainer", "object_type"]
    properties: {
      asn: {
        type: "string"
      }
      description: {
        type: "string"
      }
      mantainer: {
        type: "string"
      }
      object_type: {
        type: "string"
      }
      registry_date: {
        type: "string"
      }
      registry_status: {
        type: "string"
      }
      risk: {
        type: "string"
        enum: ["UNKNOWN", "LOW", "MEDIUM", "HIGH"]
      }
      score: {
        type: "integer"
      }
      self: {
        type: "string"
      }
    }
  }
}