zscaler-sdk-python 1.9.5__tar.gz → 1.9.6__tar.gz

{zscaler_sdk_python-1.9.5 → zscaler_sdk_python-1.9.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: zscaler-sdk-python
-Version: 1.9.5
+Version: 1.9.6
 Summary: Official Python SDK for the Zscaler Products
 Home-page: https://github.com/zscaler/zscaler-sdk-python
 License: MIT
@@ -75,6 +75,7 @@ used in your server-side code to interact with the Zscaler API platform across m
 * [ZIdentity](https://help.zscaler.com/zidentity/getting-started-zidentity-api)
 * [ZTW API](https://help.zscaler.com/cloud-branch-connector/getting-started-cloud-branch-connector-api)
 * [ZWA API](https://help.zscaler.com/workflow-automation/getting-started-workflow-automation-api)
+* [EASM API](https://hhttps://help.zscaler.com/easm/easm-api/api-developer-reference-guide/reference-guide)
 
 This SDK is designed to support the new Zscaler API framework [OneAPI](https://help.zscaler.com/oneapi/understanding-oneapi)
 via a single OAuth2 HTTP client. The SDK is also backwards compatible with the previous
@@ -93,7 +94,7 @@ This library uses semantic versioning and updates are posted in ([release notes]
 The latest release can always be found on the ([releases page](github-releases))
 
 > Requires Python version 3.8.0 or higher.
-Zscaler SDK for Python is compatible with Python 3.8 _(until [June 2023](https://devguide.python.org/versions/))_, 3.8, 3.9, 3.10, and 3.11.
+Zscaler SDK for Python is compatible with Python 3.8 _(until [June 2023](https://devguide.python.org/versions/))_, 3.9, 3.10, 3.11, and 3.12
 
 ## Need help?
 
@@ -218,6 +219,7 @@ In most cases, you won't need to build the SDK from source. If you want to build
 * [ZCC API](https://help.zscaler.com/client-connector/getting-started-client-connector-api)
 * [ZTW API](https://help.zscaler.com/cloud-branch-connector/getting-started-cloud-branch-connector-api)
 * [ZWA API](https://help.zscaler.com/workflow-automation/getting-started-workflow-automation-api)
+* [EASM API](https://hhttps://help.zscaler.com/easm/easm-api/api-developer-reference-guide/reference-guide)
 
 ## Usage guide
 
@@ -245,6 +247,7 @@ As of the publication of SDK version => 1.7.x, OneAPI is available for programma
 * [ZDX API](https://help.zscaler.com/zdx/understanding-zdx-api)
 * [ZCC API](https://help.zscaler.com/client-connector/getting-started-client-connector-api)
 * [ZTW API](https://help.zscaler.com/cloud-branch-connector/getting-started-cloud-branch-connector-api)
+* [EASM API](https://hhttps://help.zscaler.com/easm/easm-api/api-developer-reference-guide/reference-guide)
 
 **NOTE** All other products such as Zscaler Cloud Connector (ZTW) and Zscaler Digital Experience (ZDX) are supported only via the legacy authentication method described in this README.
 
@@ -1569,8 +1572,7 @@ Contributors
 - Eddie Parra - [eparra](https://github.com/eparra)
 - Paul Abbot - [abbottp](https://github.com/abbottp)
 
-Thank you to [Mitch Kelly](https://github.com/mitchos/pyZscaler), creator of the [PyZscaler](https://github.com/mitchos/pyZscaler) SDK,
-which this SDK was inspired on.
+Thank you to [Mitch Kelly](https://github.com/mitchos/pyZscaler), creator of the [PyZscaler](https://github.com/mitchos/pyZscaler) SDK, which this SDK was inspired on.
 
 ## MIT License
 

{zscaler_sdk_python-1.9.5 → zscaler_sdk_python-1.9.6}/README.md

@@ -37,6 +37,7 @@ used in your server-side code to interact with the Zscaler API platform across m
 * [ZIdentity](https://help.zscaler.com/zidentity/getting-started-zidentity-api)
 * [ZTW API](https://help.zscaler.com/cloud-branch-connector/getting-started-cloud-branch-connector-api)
 * [ZWA API](https://help.zscaler.com/workflow-automation/getting-started-workflow-automation-api)
+* [EASM API](https://hhttps://help.zscaler.com/easm/easm-api/api-developer-reference-guide/reference-guide)
 
 This SDK is designed to support the new Zscaler API framework [OneAPI](https://help.zscaler.com/oneapi/understanding-oneapi)
 via a single OAuth2 HTTP client. The SDK is also backwards compatible with the previous
@@ -55,7 +56,7 @@ This library uses semantic versioning and updates are posted in ([release notes]
 The latest release can always be found on the ([releases page](github-releases))
 
 > Requires Python version 3.8.0 or higher.
-Zscaler SDK for Python is compatible with Python 3.8 _(until [June 2023](https://devguide.python.org/versions/))_, 3.8, 3.9, 3.10, and 3.11.
+Zscaler SDK for Python is compatible with Python 3.8 _(until [June 2023](https://devguide.python.org/versions/))_, 3.9, 3.10, 3.11, and 3.12
 
 ## Need help?
 
@@ -180,6 +181,7 @@ In most cases, you won't need to build the SDK from source. If you want to build
 * [ZCC API](https://help.zscaler.com/client-connector/getting-started-client-connector-api)
 * [ZTW API](https://help.zscaler.com/cloud-branch-connector/getting-started-cloud-branch-connector-api)
 * [ZWA API](https://help.zscaler.com/workflow-automation/getting-started-workflow-automation-api)
+* [EASM API](https://hhttps://help.zscaler.com/easm/easm-api/api-developer-reference-guide/reference-guide)
 
 ## Usage guide
 
@@ -207,6 +209,7 @@ As of the publication of SDK version => 1.7.x, OneAPI is available for programma
 * [ZDX API](https://help.zscaler.com/zdx/understanding-zdx-api)
 * [ZCC API](https://help.zscaler.com/client-connector/getting-started-client-connector-api)
 * [ZTW API](https://help.zscaler.com/cloud-branch-connector/getting-started-cloud-branch-connector-api)
+* [EASM API](https://hhttps://help.zscaler.com/easm/easm-api/api-developer-reference-guide/reference-guide)
 
 **NOTE** All other products such as Zscaler Cloud Connector (ZTW) and Zscaler Digital Experience (ZDX) are supported only via the legacy authentication method described in this README.
 
@@ -1531,8 +1534,7 @@ Contributors
 - Eddie Parra - [eparra](https://github.com/eparra)
 - Paul Abbot - [abbottp](https://github.com/abbottp)
 
-Thank you to [Mitch Kelly](https://github.com/mitchos/pyZscaler), creator of the [PyZscaler](https://github.com/mitchos/pyZscaler) SDK,
-which this SDK was inspired on.
+Thank you to [Mitch Kelly](https://github.com/mitchos/pyZscaler), creator of the [PyZscaler](https://github.com/mitchos/pyZscaler) SDK, which this SDK was inspired on.
 
 ## MIT License
 

{zscaler_sdk_python-1.9.5 → zscaler_sdk_python-1.9.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "zscaler-sdk-python"
-version = "1.9.5"
+version = "1.9.6"
 description = "Official Python SDK for the Zscaler Products"
 authors = ["Zscaler, Inc. <devrel@zscaler.com>"]
 license = "MIT"

{zscaler_sdk_python-1.9.5 → zscaler_sdk_python-1.9.6}/zscaler/__init__.py

@@ -29,7 +29,7 @@ __license__ = "MIT"
 __contributors__ = [
     "William Guilherme",
 ]
-__version__ = "1.9.5"
+__version__ = "1.9.6"
 
 
 from zscaler.oneapi_client import Client as ZscalerClient  # noqa

{zscaler_sdk_python-1.9.5 → zscaler_sdk_python-1.9.6}/zscaler/helpers.py

@@ -115,10 +115,24 @@ def to_snake_case(string):
         "ziaRSAPubKey": "zia_rsa_pub_key",
         "zpaRSAPubKeyName": "zpa_rsa_pub_key_name",
         "zpaRSAPubKey": "zpa_rsa_pub_key",
-        "truncate_large_udpdns_response": "truncateLargeUDPDNSResponse",
+        "truncateLargeUDPDNSResponse": "truncate_large_udpdns_response",
         "enableZCCRevert": "enable_zcc_revert",
         "enableZiaDR": "enable_zia_dr",
         "purgeKerberosPreferredDCCache": "purge_kerberos_preferred_dc_cache",
+        # Additional ZCC camelCase edge cases
+        "enforceSplitDNS": "enforce_split_dns",
+        "packetTunnelExcludeListForIPv6": "packet_tunnel_exclude_list_for_ipv6",
+        "packetTunnelIncludeListForIPv6": "packet_tunnel_include_list_for_ipv6",
+        "oneIdMTDeviceAuthEnabled": "one_id_mt_device_auth_enabled",
+        "enableAPCforCriticalSections": "enable_apc_for_critical_sections",
+        "enableAPCforOtherSections": "enable_apc_for_other_sections",
+        "enablePCAdditionalSpace": "enable_pc_additional_space",
+        "bypassDNSTrafficUsingUDPProxy": "bypass_dns_traffic_using_udp_proxy",
+        "useEndPointLocationForDCSelection": "use_end_point_location_for_dc_selection",
+        "overrideATCmdByPolicy": "override_at_cmd_by_policy",
+        "customDNS": "custom_dns",
+        "ziaDRMethod": "zia_dr_method",
+        "dropQuicTraffic": "drop_quic_traffic",
 
         # ZPA Edge Cases
         "serverGroupDTOs": "server_group_dtos",
@@ -254,11 +268,25 @@ def to_lower_camel_case(string):
         "zia_rsa_pub_key": "ziaRSAPubKey",
         "zpa_rsa_pub_key_name": "zpaRSAPubKeyName",
         "zpa_rsa_pub_key": "zpaRSAPubKey",
-        "truncateLargeUDPDNSResponse": "truncate_large_udpdns_response",
+        "truncate_large_udpdns_response": "truncateLargeUDPDNSResponse",
         "enable_zcc_revert": "enableZCCRevert",
         "delete_dhcp_option121_routes": "deleteDHCPOption121Routes",
-        "enableZiaDR": "enable_zia_dr",
-        "purgeKerberosPreferredDCCache": "purge_kerberos_preferred_dc_cache",
+        "enable_zia_dr": "enableZiaDR",
+        "purge_kerberos_preferred_dc_cache": "purgeKerberosPreferredDCCache",
+        # Additional ZCC snake_case edge cases
+        "enforce_split_dns": "enforceSplitDNS",
+        "packet_tunnel_exclude_list_for_ipv6": "packetTunnelExcludeListForIPv6",
+        "packet_tunnel_include_list_for_ipv6": "packetTunnelIncludeListForIPv6",
+        "one_id_mt_device_auth_enabled": "oneIdMTDeviceAuthEnabled",
+        "enable_apc_for_critical_sections": "enableAPCforCriticalSections",
+        "enable_apc_for_other_sections": "enableAPCforOtherSections",
+        "enable_pc_additional_space": "enablePCAdditionalSpace",
+        "bypass_dns_traffic_using_udp_proxy": "bypassDNSTrafficUsingUDPProxy",
+        "use_end_point_location_for_dc_selection": "useEndPointLocationForDCSelection",
+        "override_at_cmd_by_policy": "overrideATCmdByPolicy",
+        "custom_dns": "customDNS",
+        "zia_dr_method": "ziaDRMethod",
+        "drop_quic_traffic": "dropQuicTraffic",
 
         # ZPA Edge Cases
         "server_group_dtos": "serverGroupDTOs",

{zscaler_sdk_python-1.9.5 → zscaler_sdk_python-1.9.6}/zscaler/oneapi_client.py

@@ -17,6 +17,7 @@ from zscaler.zia.zia_service import ZIAService
 from zscaler.zpa.zpa_service import ZPAService
 from zscaler.zwa.zwa_service import ZWAService
 from zscaler.zidentity.zidentity_service import ZIdentityService
+from zscaler.zeasm.zeasm_service import ZEASMService
 from zscaler.zcc.legacy import LegacyZCCClientHelper
 from zscaler.ztw.legacy import LegacyZTWClientHelper
 from zscaler.zdx.legacy import LegacyZDXClientHelper
@@ -192,6 +193,7 @@ class Client:
         self._zpa = None
         self._zdx = None
         self._zidentity = None
+        self._zeasm= None
         # self.logger.debug("Client initialized successfully.")
 
     def authenticate(self):
@@ -262,6 +264,12 @@ class Client:
         if self._zidentity is None:
             self._zidentity = ZIdentityService(self._request_executor)
         return self._zidentity
+    
+    @property
+    def zeasm(self):
+        if self._zeasm is None:
+            self._zeasm = ZEASMService(self._request_executor)
+        return self._zeasm
 
     def __enter__(self):
         """

{zscaler_sdk_python-1.9.5 → zscaler_sdk_python-1.9.6}/zscaler/oneapi_response.py

@@ -193,6 +193,12 @@ class ZscalerAPIResponse:
             self._results_total = self._body.get("results_total")
             self._page_offset = self._body.get("pageOffset")
             self._page_size = self._body.get("pageSize")
+        elif self._service_type == "zeasm":
+            # ZEASM uses "results" field for paginated responses
+            self._list = self._body.get("results", [])
+            self._total_results = self._body.get("total_results", 0)
+            self._next_page = self._body.get("next_page")
+            self._prev_page = self._body.get("prev_page")
         elif self._service_type == "ZCC":
             # ZCC can return either a single object or a list of objects
             if isinstance(self._body, dict):

{zscaler_sdk_python-1.9.5 → zscaler_sdk_python-1.9.6}/zscaler/request_executor.py

@@ -180,6 +180,8 @@ class RequestExecutor:
             return "zidentity"
         elif "/admin" in url:
             return "admin"
+        elif "/easm/easm-ui/v1" in url:
+            return "zeasm"
         if self.use_legacy_client:
             url = self.remove_oneapi_endpoint_prefix(url)
             # Recheck for service type after removing the prefix
@@ -197,7 +199,6 @@ class RequestExecutor:
                 return "zpa"
             elif "/admin/api/v1" in url:
                 return "zidentity"
-
         raise ValueError(f"Unsupported service: {url}")
 
     def remove_oneapi_endpoint_prefix(self, endpoint: str) -> str:
@@ -314,6 +315,10 @@ class RequestExecutor:
         if "/zdx/" in endpoint:
             return body  # Do not convert ZDX requests to camelCase
 
+        # Special handling for ZEASM endpoints - keep snake_case format
+        if "/easm/" in endpoint:
+            return body  # Do not convert ZEASM requests to camelCase
+
         # Special handling for ZCC service - use selective conversion
         if "/zcc/" in endpoint and body:
             from zscaler.helpers import convert_keys_to_camel_case_selective

{zscaler_sdk_python-1.9.5 → zscaler_sdk_python-1.9.6}/zscaler/utils.py

@@ -841,6 +841,23 @@ def zcc_param_mapper(func):
             else:
                 mapped_params["osTypes"] = ",".join(mapped)
 
+        # Handle device_type (uses same mapping as os_type)
+        raw_device_type = (
+            query_params.get("device_type") or
+            body.get("device_type")
+        )
+
+        if raw_device_type:
+            raw_device_type = [raw_device_type] if isinstance(raw_device_type, str) else raw_device_type
+            mapped = [
+                str(zcc_param_map["os"].get(dt.lower()) if isinstance(dt, str) else dt)
+                for dt in raw_device_type
+                if (isinstance(dt, str) and zcc_param_map["os"].get(dt.lower())) or isinstance(dt, int)
+            ]
+            if not mapped:
+                raise ValueError("Invalid `device_type` provided. Valid options: ios, android, windows, macos, linux.")
+            mapped_params["deviceType"] = ",".join(mapped)
+
         raw_reg = (
             query_params.get("registration_type") or
             query_params.get("registration_types") or
@@ -907,9 +924,10 @@ def zcc_param_mapper(func):
         # Clean aliases
         for key in [
             "os_type", "os_types",
+            "device_type",
             "registration_type", "registration_types",
             "start_date", "startDate",
-            "end_date", "endDate", 
+            "end_date", "endDate",
             "time_zone", "Time-Zone",
         ]:
             query_params.pop(key, None)

{zscaler_sdk_python-1.9.5 → zscaler_sdk_python-1.9.6}/zscaler/zcc/models/webpolicy.py

@@ -309,6 +309,7 @@ class PolicyExtension(ZscalerObject):
         super().__init__(config)
 
         if config:
+            self.id = config["id"] if "id" in config else None
             self.source_port_based_bypasses = config["sourcePortBasedBypasses"] \
                 if "sourcePortBasedBypasses" in config else None
             self.vpn_gateways = config["vpnGateways"] \
@@ -439,6 +440,7 @@ class PolicyExtension(ZscalerObject):
                 if "enableFlowBasedTunnel" in config else None
 
         else:
+            self.id = None
             self.source_port_based_bypasses = None
             self.vpn_gateways = None
             self.packet_tunnel_exclude_list = None
@@ -484,7 +486,7 @@ class PolicyExtension(ZscalerObject):
             self.update_dns_search_order = None
             self.truncate_large_udpdns_response = None
             self.prioritize_dns_exclusions = None
-            self.purge_kerberos_preferred_d_c_cache = None
+            self.purge_kerberos_preferred_dc_cache = None
             self.delete_dhcp_option121_routes = None
             self.generate_cli_password_contract = None
             self.zdx_lite_config_obj = None
@@ -554,7 +556,7 @@ class PolicyExtension(ZscalerObject):
             "updateDnsSearchOrder": self.update_dns_search_order,
             "truncateLargeUDPDNSResponse": self.truncate_large_udpdns_response,
             "prioritizeDnsExclusions": self.prioritize_dns_exclusions,
-            "purgeKerberosPreferredDCCache": self.purge_kerberos_preferred_d_c_cache,
+            "purgeKerberosPreferredDCCache": self.purge_kerberos_preferred_dc_cache,
             "deleteDHCPOption121Routes": self.delete_dhcp_option121_routes,
             "generateCliPasswordContract": self.generate_cli_password_contract,
             "zdxLiteConfigObj": self.zdx_lite_config_obj,

zscaler_sdk_python-1.9.6/zscaler/zeasm/findings.py

@@ -0,0 +1,253 @@
+"""
+Copyright (c) 2023, Zscaler Inc.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+"""
+
+from typing import Dict, List, Optional, Any, Union
+from zscaler.api_client import APIClient
+from zscaler.request_executor import RequestExecutor
+from zscaler.zeasm.models.findings import CommonFindings, Findings, FindingDetails
+from zscaler.utils import format_url
+from zscaler.types import APIResult
+
+
+class FindingsAPI(APIClient):
+    """
+    A Client object for the ZEASM Findings resource.
+
+    This class provides methods to interact with ZEASM findings,
+    allowing you to retrieve findings identified and tracked for an
+    organization's internet-facing assets scanned by EASM.
+    """
+
+    _zeasm_base_endpoint = "/easm/easm-ui/v1"
+
+    def __init__(self, request_executor: "RequestExecutor") -> None:
+        super().__init__()
+        self._request_executor: RequestExecutor = request_executor
+
+    def list_findings(self, org_id: str) -> APIResult[Findings]:
+        """
+        Retrieves the list of findings identified and tracked for an organization's
+        internet-facing assets scanned by EASM.
+
+        Args:
+            org_id (str): The unique identifier for the organization.
+
+        Returns:
+            tuple: A tuple containing:
+                - Findings: Object containing results list and total_results count
+                - Response: The raw API response object
+                - error: Any error that occurred, or None if successful
+
+        Examples:
+            List all findings for an organization::
+
+                >>> findings, _, err = client.zeasm.findings.list_findings(
+                ...     org_id="3f61a446-1a0d-11f0-94e8-8a5f4d45e80c"
+                ... )
+                >>> if err:
+                ...     print(f"Error: {err}")
+                ...     return
+                >>> print(f"Total findings: {findings.total_results}")
+                >>> for finding in findings.results:
+                ...     print(f"  ID: {finding.id}, Category: {finding.category}")
+        """
+        http_method = "get".upper()
+        api_url = format_url(
+            f"""
+            {self._zeasm_base_endpoint}
+            /organizations/{org_id}/findings
+        """
+        )
+
+        body = {}
+        headers = {}
+
+        request, error = self._request_executor.create_request(http_method, api_url, body, headers)
+
+        if error:
+            return (None, None, error)
+
+        response, error = self._request_executor.execute(request)
+
+        if error:
+            return (None, response, error)
+
+        try:
+            result = Findings(response.get_body())
+        except Exception as error:
+            return (None, response, error)
+        return (result, response, None)
+
+    def get_finding_details(self, org_id: str, finding_id: str) -> APIResult[FindingDetails]:
+        """
+        Retrieves details for a finding based on the specified ID.
+
+        Args:
+            org_id (str): The unique identifier for the organization.
+            finding_id (str): The unique identifier for the finding.
+
+        Returns:
+            tuple: A tuple containing:
+                - FindingDetails: Object containing the finding details
+                - Response: The raw API response object
+                - error: Any error that occurred, or None if successful
+
+        Examples:
+            Get details for a specific finding::
+
+                >>> finding, _, err = client.zeasm.findings.get_finding_details(
+                ...     org_id="3f61a446-1a0d-11f0-94e8-8a5f4d45e80c",
+                ...     finding_id="8abfc6a2b3058cb75de44c4c65ca4641"
+                ... )
+                >>> if err:
+                ...     print(f"Error: {err}")
+                ...     return
+                >>> print(finding.as_dict())
+        """
+        http_method = "get".upper()
+        api_url = format_url(
+            f"""
+            {self._zeasm_base_endpoint}
+            /organizations/{org_id}/findings/{finding_id}/details
+        """
+        )
+
+        body = {}
+        headers = {}
+
+        request, error = self._request_executor.create_request(http_method, api_url, body, headers)
+
+        if error:
+            return (None, None, error)
+
+        response, error = self._request_executor.execute(request, FindingDetails)
+        if error:
+            return (None, response, error)
+
+        try:
+            result = FindingDetails(response.get_body())
+        except Exception as error:
+            return (None, response, error)
+        return (result, response, None)
+
+    def get_finding_evidence(self, org_id: str, finding_id: str) -> APIResult[CommonFindings]:
+        """
+        Retrieves scan evidence details for a finding based on the specified ID.
+
+        This is a subset of the scan output obtained for the associated asset
+        that can be attributed to the finding.
+
+        Args:
+            org_id (str): The unique identifier for the organization.
+            finding_id (str): The unique identifier for the finding.
+
+        Returns:
+            tuple: A tuple containing:
+                - CommonFindings: Object containing the evidence content and source_type
+                - Response: The raw API response object
+                - error: Any error that occurred, or None if successful
+
+        Examples:
+            Get evidence for a specific finding::
+
+                >>> evidence, _, err = client.zeasm.findings.get_finding_evidence(
+                ...     org_id="3f61a446-1a0d-11f0-94e8-8a5f4d45e80c",
+                ...     finding_id="8abfc6a2b3058cb75de44c4c65ca4641"
+                ... )
+                >>> if err:
+                ...     print(f"Error: {err}")
+                ...     return
+                >>> if evidence:
+                >>>     print(evidence.as_dict())
+        """
+        http_method = "get".upper()
+        api_url = format_url(
+            f"""
+            {self._zeasm_base_endpoint}
+            /organizations/{org_id}/findings/{finding_id}/evidence
+        """
+        )
+
+        body = {}
+        headers = {}
+
+        request, error = self._request_executor.create_request(http_method, api_url, body, headers)
+
+        if error:
+            return (None, None, error)
+
+        response, error = self._request_executor.execute(request, CommonFindings)
+        if error:
+            return (None, response, error)
+
+        try:
+            result = CommonFindings(response.get_body())
+        except Exception as error:
+            return (None, response, error)
+        return (result, response, None)
+
+    def get_finding_scan_output(self, org_id: str, finding_id: str) -> APIResult[CommonFindings]:
+        """
+        Retrieves the complete scan output for a finding based on the specified ID.
+
+        Args:
+            org_id (str): The unique identifier for the organization.
+            finding_id (str): The unique identifier for the finding.
+
+        Returns:
+            tuple: A tuple containing:
+                - CommonFindings: Object containing the scan output content and source_type
+                - Response: The raw API response object
+                - error: Any error that occurred, or None if successful
+
+        Examples:
+            Get complete scan output for a specific finding::
+
+                >>> scan_output, _, err = client.zeasm.findings.get_finding_scan_output(
+                ...     org_id="3f61a446-1a0d-11f0-94e8-8a5f4d45e80c",
+                ...     finding_id="8abfc6a2b3058cb75de44c4c65ca4641"
+                ... )
+                >>> if err:
+                ...     print(f"Error: {err}")
+                ...     return
+                >>> if finding:
+                >>>     print(finding.as_dict())
+        """
+        http_method = "get".upper()
+        api_url = format_url(
+            f"""
+            {self._zeasm_base_endpoint}
+            /organizations/{org_id}/findings/{finding_id}/scan-output
+        """
+        )
+
+        body = {}
+        headers = {}
+
+        request, error = self._request_executor.create_request(http_method, api_url, body, headers)
+
+        if error:
+            return (None, None, error)
+
+        response, error = self._request_executor.execute(request, CommonFindings)
+        if error:
+            return (None, response, error)
+
+        try:
+            result = CommonFindings(response.get_body())
+        except Exception as error:
+            return (None, response, error)
+        return (result, response, None)