---
updatedAt: 2026-03-01T18:29:19.000Z
---

# List agent groups

This returns an array of all agent group identifiers and their corresponding descriptions. You can use this to retrieve a human-readable equivalent of the `agentGroupId` numbers.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Service-Level Agreement API",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://{hostname}/sla-api/v1"
    }
  ],
  "paths": {
    "/agent-groups": {
      "get": {
        "operationId": "get-agent-groups",
        "summary": "List agent groups",
        "tags": [
          "Agent Groups"
        ],
        "description": "This returns an array of all agent group identifiers and their corresponding descriptions. You can use this to retrieve a human-readable equivalent of the `agentGroupId` numbers.\n",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": [
                  {
                    "agentGroupId": 1,
                    "name": "Australia SLA"
                  },
                  {
                    "agentGroupId": 5,
                    "name": "North American SLA"
                  }
                ],
                "schema": {
                  "type": "array",
                  "minItems": 1,
                  "uniqueItems": true,
                  "items": {
                    "type": "object",
                    "description": "Represents the set of possible agents in which tests for a given SLA test configuration are run. Agents groups are defined by geographical location. This setting usually corresponds to the regional SLA provided to you with your purchase.\n",
                    "required": [
                      "agentGroupId",
                      "name"
                    ],
                    "properties": {
                      "agentGroupId": {
                        "type": "integer",
                        "description": "Code representing the agent group (also called a region or regional SLA) for the test configuration. See [agentGroupId values](https://techdocs.akamai.com/sla/reference/agentgroupid-values).\n"
                      },
                      "name": {
                        "type": "string",
                        "description": "Descriptive name of an agent group indicating its geographical region.\n",
                        "minLength": 1
                      }
                    }
                  }
                }
              }
            },
            "description": "OK\n"
          }
        }
      }
    }
  },
  "x-readme": {
    "samples-languages": [
      "curl",
      "python",
      "node"
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "externalDocs": {
    "url": "https://techdocs.akamai.com/sla/reference",
    "description": "See documention for Akamai's Service-Level Agreement API"
  }
}
```