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

# Getting the List of Build Groups

The Groups/list API allows you to return a list of all Build Groups in a specific Coordinator, as well as the total number of Agents in each of the Build Groups.

 **Request Syntax**

GET https\://\{Coordinator IP Address/Hostname}:\{Web Access Port}/Groups/list

Where:

* Web Access Port is the port number defined in the [**Coordinator Settings** dialog box](/windows/assigning-agents-to-build-groups) (default**31100**).

For example:

GET [https://win10-1:31100/Groups/list](https://win10-1:31100/Groups/list)

**Response Syntax**

Returns a list of the Build Groups in the Coordinator, with the number of Agents in each Build Group. 

For example:

```text theme={null}
[
    {
        "AgentCount": 1,
        "Group": "Default"
    },

    {
        "AgentCount": 3,
        "Group": "Dev"
    },

    {
        "AgentCount": 0,
        "Group": "QA"
    }
]
```

Where:

* AgentCount – the number of Agents in the Build Group.

* Group – the name of the Build Group.
