> For the complete documentation index, see [llms.txt](https://docs.does.qa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.does.qa/test-steps/integration/sftp-list.md).

# SFTP List

SFTP List reads a remote directory and stores the listing. Use it when a later Check or step needs to know what already sits on the host.

![SFTP List Test Step](https://app.does.qa/screenshots/node/integration_sftp_list.png)

## When to use it

* Confirm files after [SFTP Upload](/test-steps/integration/sftp-upload.md).
* Capture a directory listing into a Value for later Checks.

## Configure

### Connection

| Field        | What to set                                       |
| ------------ | ------------------------------------------------- |
| **URL**      | Host text and/or [Values](/values/value-store.md) |
| **Port**     | `22` by default                                   |
| **User**     | Username text and/or Values                       |
| **Password** | Password text and/or Values                       |

### Directory

| Field                     | What to set                         |
| ------------------------- | ----------------------------------- |
| **Path**                  | Remote directory text and/or Values |
| **Type**                  | `Files` by default                  |
| **Response Storage Name** | Value name for the listing response |

{% hint style="info" %}
**Pro tip:** Use the same connection Values as SFTP Upload so list and upload stay pointed at one host.
{% endhint %}

## Related

* [SFTP Upload](/test-steps/integration/sftp-upload.md)
* [Check SFTP file exists](/test-steps/check/check-sftp-file-exists.md)
* [Check SFTP file count](/test-steps/check/check-sftp-file-count.md)
* [Integration](/test-steps/integration.md)

**Tags:** `integration`, `sftp`, `list`