> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/scan-details/reachability-tests.md).

# Reachability Tests

Check whether Traceable could reach your API endpoints before a scan ran its tests, and use the results to troubleshoot scan coverage

The **Reachability Tests** tab provides visibility into whether Traceable can successfully reach API endpoints before generating and executing security tests during a scan.

## What you will learn from this topic

By the end of this topic, you will be able to understand:

* The details displayed in the **Reachability Tests** tab.
* The way Traceable determines an endpoint's reachability status.
* The way you can use reachability data to troubleshoot scan coverage.

***

## Before you begin

Make a note of the following before you review reachability tests:

* Ensure that you are using CLI version *2.5.0* and above, as this tab displays data only from that version onward. Go to [Runners and CLI](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/runners-and-cli.md) for more details.
* Make sure that you understand traffic types as Traceable executes reachability tests differently for each one. Go to [Understanding Scans and Traffic Types](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/understanding-scans-and-traffic-types.md) for more details.

***

## Understand reachability testing

Traceable executes reachability tests differently depending on the traffic type:

* **XAST Replay** scans: Traceable replays previously captured traces for each endpoint.
* **XAST Live** scans: Traceable uses the data incoming after scan creation.
* **DAST** scans: Traceable uses request samples from the specification file that you uploaded during scan creation.

These reachability tests are executed without applying mutations or assertions. Based on the response received, Traceable determines whether the endpoint is reachable and eligible for security testing.

{% hint style="info" %}
Traceable generates security tests only for endpoints that are successfully reachable. If an endpoint is unreachable, no security tests are generated for that endpoint in the **Tests** tab. Go to [Tests](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/scan-details/tests.md) for more details.
{% endhint %}

***

## Understand the Reachability Tests tab

Reachability tests tab provides insights on the status of the API endpoint. You can use it to find the endpoints that Traceable could not reach or authenticate to, and to understand why Traceable did not test them. The tab displays a table for a scan run with the following details:

| Column            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **API Endpoint**  | Displays the API endpoint for which Traceable executed the reachability test.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Service**       | Displays the backend service or application that handles or exposes the API.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Status**        | <p>Displays the reachability status of the endpoint, as <em>Reachable</em>, <em>Unreachable</em>, <em>Authentication Failed</em>, or <em>Error:</em></p><ul><li><em>Reachable:</em> Traceable received a successful response from the endpoint, for example, an <em>HTTP 2xx</em> or <em>3xx</em> status code.</li><li><em>Unreachable:</em> Traceable received an unsuccessful response from the endpointor example, <em>HTTP 4xx</em> or <em>5xx</em>, excluding authentication failures.</li><li><em>Authentication Failed:</em> Traceable received an authentication-related failure from the endpoint, for example, <em>HTTP 401</em>, <em>403</em>, or <em>407</em>.</li><li><em>Error:</em> Traceable could not send the request to the endpoint.</li></ul> |
| **Response Code** | Displays the HTTP or gRPC response code returned by the endpoint during the reachability test.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |

If an endpoint is temporarily unreachable, Traceable retries the reachability test multiple times before determining the final status.

<figure><img src="https://1414883571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdr7UJpJrdGkkSGT6AFTu%2Fuploads%2Fgit-blob-797cfc36e3ffdf7b59d64b9a6e5f73aa6432895b%2Ftraceable_ast_scandetails_reachability.png?alt=media" alt="Traceeable APIST Scan details Reachability tab"><figcaption><p>Reachability Tab</p></figcaption></figure>

### Actions in the Reachability Tests tab

Traceable provides the following actions in the tab:

| Action            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Filter** icon   | <p>Refines the data displayed in the tab by the following attributes:</p><ul><li><strong>Status</strong>: The reachability status of the endpoint, such as <em>Reachable</em>, <em>Unreachable</em>, or <em>Authentication Failed</em>.</li><li><strong>Response Code</strong>: The response code returned by the endpoint during the reachability test.</li><li><strong>API Endpoint</strong>: The API endpoint for which Traceable executed the reachability test.</li></ul><p>After you apply a filter, you can save it for later use under <strong>Filter → Saved</strong>.</p> |
| **Search** bar    | Locates a specific endpoint by typing its details.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Download** icon | Downloads the list of reachability tests associated with a scan for offline analysis as a CSV[^1] file.                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |

***

## Understand the reachability tests panel

The reachability test slide-out panel provides the request that Traceable sent to an endpoint during the reachability test and the response it received. You can use it to see why Traceable marked the endpoint as reachable or unreachable, and to reproduce the request yourself. Click an endpoint in the table to open the panel, which displays the following details:

| Field                  | Description                                                                                                                                |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Endpoint**           | Displays the method and path of the API endpoint that Traceable tested.                                                                    |
| **Service**            | Displays the backend service or application that handles or exposes the API.                                                               |
| **Status Code**        | Displays the status code the endpoint returned for the test request.                                                                       |
| **Execution Category** | Displays the execution outcome of the test, for example, *Success*.                                                                        |
| **URI**                | Displays the full URI[^2] of the test request.                                                                                             |
| **Duration**           | Displays the time the endpoint took to respond to the test request.                                                                        |
| **Original Trace Id**  | Displays the ID of the trace on which Traceable based the test. You can copy the ID, or click the arrow icon next to it to open the trace. |

The panel also provides the following actions, located at the top:

* **View Traces**: Opens the traces associated with the test.
* **Copy as cURL**: Opens the **Copy cURL command for reverification** pop-up window. You can click **Copy** to copy the test request as a cURL command and run it yourself.

<figure><img src="https://1414883571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdr7UJpJrdGkkSGT6AFTu%2Fuploads%2Fgit-blob-28461b4f622cba30bf49f1d1e0ee7bbfae087bd1%2Ftraceable_ast_scandetails_reachability_slideoutpanel.png?alt=media" alt=""><figcaption><p>Reachability Tests slide-out panel</p></figcaption></figure>

{% hint style="info" %}
Traceable tags each reachability request with the `x-traceable-ast-plugin` and `x-traceable-ast-signature` headers, which identify the request as a Traceable check rather than real application traffic.
{% endhint %}

***

## Leverage the data shown in the tab

You can use the **Reachability Tests** tab to understand endpoint availability and interpret scan behavior more effectively.

For example, if security tests are not generated for certain endpoints in the **Tests** tab, you can review their reachability status to determine whether the endpoints were unreachable or blocked due to authentication failures during the scan.

Similarly, if multiple endpoints show an *Authentication Failed* status, you can verify whether the configured authentication settings allow Traceable to access the endpoints correctly.

Consistent *Reachable* statuses across endpoints indicate that Traceable can successfully replay traffic and proceed with generating security tests. Unexpected spikes in *Unreachable* or *Error* statuses may indicate configuration issues, environment instability, or changes in endpoint availability.

The **Reachability Tests** tab helps you:

* Identify endpoints that are not eligible for security testing.
* Troubleshoot authentication and connectivity issues.
* Validate endpoint availability before generating security tests.
* Analyze changes in endpoint reachability across scan executions.

***

## Resume scan analysis

Once you have confirmed which endpoints Traceable could reach, you can continue your analysis in the other tabs of the Scan Details page:

* To see the security tests generated for the reachable endpoints, open the **Tests** tab. Go to [Tests](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/scan-details/tests.md) for more details.
* To see how thoroughly Traceable tested those endpoints, open the **API Coverage** tab. Go to [API Coverage](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/scan-details/api-coverage.md) for more details.
* To review the vulnerabilities detected on them, open the **Issues** tab. Go to [Issues](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/scan-details/issues.md) for more details.
* To check runner health and domain reachability for the run, open the **Scan Runs** tab. Go to [Scan Runs](https://developer.harness.io/web-application-and-api-protection-waap-discovery-discovery-api-security-testing/api-security-testing/ast-basics-and-workflow/scan-details/scan-runs.md) for more details.

[^1]: Comma Separated Values

[^2]: Uniform Resource Identifier
