---
title: "Agent.GetList - Web Scraping API - Mozenda"
slug: "agentgetlist"
description: "Agent.Getlist returns a list of web scraping agents associated with your account, along with each agent's ID, Name, Settings, and Description. "
updated: 2026-08-19T20:43:56Z
published: 2026-08-25T14:00:00Z
canonical: "help.mozenda.com/agentgetlist"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.mozenda.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent.GetList

### Description

Returns a list of your **agents** with their *ID, Name, Settings, Description, Geolocation, ProxyPool, CollectionID*, and other important information.

### URL parameters

| Name | Required | Type | Description |
| --- | --- | --- | --- |
| `IncludeStartingURL` | False | boolean | Whether the response should include the staring **URL** of the **agent**. Default is *False*. |

### Responses

| Name | Type | Description |
| --- | --- | --- |
| `Result` | string | `Success` if the operation was successful. |
| `Agent` | [Agent](https://help.mozenda.com/docs/api-response-objects/#agent) | Information on all **agents** in the account. |

### Sample request

```
curl -X GET "https://api.mozenda.com/rest?WebServiceKey=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX&Service=Mozenda10&Operation=Agent.GetList"
```

### Sample responses

#### XML

```
<AgentGetListResponse
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema">
	<script id="eppiocemhmnlbhjplcgkofciiegomcon"/>
	<script/>
	<script/>
	<Result>Success</Result>
	<AgentList>
		<Agent>
			<Created>2018-11-19 06:14:50</Created>
			<Modified>2024-04-16 09:08:00</Modified>
			<AgentID>1001</AgentID>
			<Name>Mozenda-01</Name>
			<Description/>
			<Settings>BrowserIsolation, ConvertedIEAgent, MaximizeBrowserWindow, SingleBrowser, UseAnonymizer</Settings>
			<Status>Ready</Status>
			<Geolocation>NorthAmerica</Geolocation>
			<ProxyPool/>
			<CollectionID>1002</CollectionID>
			<AgentGroupID/>
			<TemplateID>22434</TemplateID>
			<TemplateOverrides>{"Parameters":{"View":"23361","Number":""}}</TemplateOverrides>
			<IsLocked>False</IsLocked>
		</Agent>
		<Agent>
			<Created>2018-11-20 06:37:07</Created>
			<Modified>2021-03-31 12:10:45</Modified>
			<AgentID>1002</AgentID>
			<Name>Mozenda-02</Name>
			<Description/>
			<Settings>BrowserIsolation, MaximizeBrowserWindow, SingleBrowser, UseAnonymizer, ConvertedIEAgent</Settings>
			<Status>Ready</Status>
			<Geolocation>NorthAmerica</Geolocation>
			<ProxyPool/>
			<CollectionID>1003</CollectionID>
			<AgentGroupID/>
			<TemplateID>22434</TemplateID>
			<TemplateOverrides>{"Parameters":{"View":"23361","Number":""}}</TemplateOverrides>
			<IsLocked>False</IsLocked>
		</Agent>
		<Agent>
			<Created>2018-11-26 00:21:32</Created>
			<Modified>2021-03-31 12:10:45</Modified>
			<AgentID>1007</AgentID>
			<Name>Mozenda-03</Name>
			<Description/>
			<Settings>BrowserIsolation, MaximizeBrowserWindow, SingleBrowser, ConvertedIEAgent</Settings>
			<Status>Ready</Status>
			<Geolocation/>
			<ProxyPool/>
			<CollectionID>1008</CollectionID>
			<AgentGroupID>1245</AgentGroupID>
			<TemplateID>22434</TemplateID>
			<TemplateOverrides>{"Parameters":{"View":"23361","Number":""}}</TemplateOverrides>
			<IsLocked>False</IsLocked>
		</Agent>
	</AgentList>
</AgentGetListResponse>
```

#### JSON (add `&amp;ResponseFormat=JSON`)

```
{
  "Agent": [
    {
      "Created": "2018-11-19 06:14:50",
      "Modified": "2024-04-16 09:08:00",
      "AgentID": 1001,
      "Name": "Mozenda-01",
      "Description": "",
      "Settings": "BrowserIsolation, ConvertedIEAgent, MaximizeBrowserWindow, SingleBrowser, UseAnonymizer",
      "Status": "Ready",
      "Geolocation": "NorthAmerica",
      "ProxyPool": "",
      "CollectionID": "1002"
      "AgentGroupID": "",
      "TemplateID": "22434",
      "TemplateOverrides": "{\"Parameters\":{\"View\":\"23361\",\"Number\":\"\"}}",
      "IsLocked": "False"
    },
    {
      "Created": "2018-11-20 06:37:07",
      "Modified": "2021-03-31 12:10:45",
      "AgentID": 1002,
      "Name": "Mozenda-02",
      "Description": "",
      "Settings": "BrowserIsolation, MaximizeBrowserWindow, SingleBrowser, UseAnonymizer, ConvertedIEAgent",
      "Status": "Ready",
      "Geolocation": "NorthAmerica",
      "ProxyPool": "",
      "CollectionID": "1003",
      "AgentGroupID": "",
      "TemplateID": "22434",
      "TemplateOverrides": "{\"Parameters\":{\"View\":\"23361\",\"Number\":\"\"}}",
      "IsLocked": "False"
    },
    {
      "Created": "2018-11-26 00:21:32",
      "Modified": "2021-03-31 12:10:45",
      "AgentID": 1007,
      "Name": "Mozenda-03",
      "Description": "",
      "Settings": "BrowserIsolation, MaximizeBrowserWindow, SingleBrowser, ConvertedIEAgent",
      "Status": "Ready",
      "Geolocation": "",
      "ProxyPool": "",
      "CollectionID": "1008",
      "AgentGroupID": "1235",
      "TemplateID": "22434",
      "TemplateOverrides": "{\"Parameters\":{\"View\":\"23361\",\"Number\":\"\"}}",
      "IsLocked": "False"
    }
}
```