> For the complete documentation index, see [llms.txt](https://docs.tailent.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tailent.com/getting-started/tailent-gateway-agent/tap-gateway-agent-api-references/bot-list.md).

# Bot List

<pre class="language-http"><code class="lang-http"><strong>[GET] https://tap.gateway:port/Status/list
</strong></code></pre>

## Request headers

This is a simple **GET** request that requires no parameters.&#x20;

## Request body

This is a simple **GET** request that does not require a body.

## Returns

The TGA should reply with a code 200 and the bot instance list as an array, in JSON format:

```json
[
	{
		"guid": "f978fa59-706a-4768-9876-86e629649315",
		"status": "Stopped",
		"path": "C:\\Tailent\\Test\\Test.tap",
		"start": "2024-10-09T05:32:42.5363939-07:00"
	},
	{
		"guid": "2777f2d5-dbf1-41a0-ad1a-b2c9b9388baf",
		"status": "Running",
		"path": "C:\\Tailent\\Test\\Test.tap",
		"start": "2024-10-09T05:33:16.4779509-07:00"
	}
]
```

**guid -** represents the bot instance guid, which is generated with the [Start Session Bot](/getting-started/tailent-gateway-agent/tap-gateway-agent-api-references/start-session-bot.md) request.

**status** - represents the current status of the bot; this can be Stopped or Running.

**path** - represents the path of the .tap automation file

**start** - represents the starting time of the bot instance.

## Example curl request

```sh
curl --request GET \
  --url https://localhost:65001/Status/list \
```