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

# List API Proxy Groups

> Retrieves all API Proxy Groups for a specified project. API Proxy Groups allow you to group multiple API Proxies together and manage them as a single unit.

## Endpoint

```plaintext theme={null}
GET /apiops/projects/{projectName}/apiProxyGroups/
```

## Authentication

Requires a Personal API Access Token.

### Header

```plaintext theme={null}
Authorization: Bearer YOUR_TOKEN
```

## Request

### Headers

| Header        | Value          | Required |
| ------------- | -------------- | -------- |
| Authorization | Bearer {token} | Yes      |

### Path Parameters

| Parameter   | Type   | Required | Description  |
| ----------- | ------ | -------- | ------------ |
| projectName | string | Yes      | Project name |

### Query Parameters

None.

## Response

### Success Response (200 OK)

```json theme={null}
{
  "success": true,
  "resultList": [
    {
      "id": "group-id-1",
      "name": "PaymentAPIGroup",
      "description": "Payment API Group"
    },
    {
      "id": "group-id-2",
      "name": "UserAPIGroup",
      "description": "User Management API Group"
    }
  ],
  "resultCount": 2
}
```

#### Response Fields

| Field       | Type           | Description                             |
| ----------- | -------------- | --------------------------------------- |
| success     | boolean        | Indicates if the request was successful |
| resultList  | array\[object] | List of API Proxy Groups                |
| resultCount | integer        | Total number of API Proxy Groups        |

#### API Proxy Group Object

| Field       | Type   | Description                 |
| ----------- | ------ | --------------------------- |
| id          | string | API Proxy Group ID          |
| name        | string | API Proxy Group name        |
| description | string | API Proxy Group description |

### Notes

* Returns only basic information (id, name, description)
* Empty list (`[]`) is returned if no groups exist
* `resultCount` is 0 if no groups exist

### Error Response (401 Unauthorized)

```json theme={null}
{
  "error": "unauthorized_client",
  "error_description": "Invalid token"
}
```

### Error Response (404 Not Found)

```json theme={null}
{
  "error": "not_found",
  "error_description": "Project(MyProject) was not found or user does not have privilege to access it!"
}
```

## cURL Example

```bash theme={null}
curl -X GET \
  "https://demo.apinizer.com/apiops/projects/MyProject/apiProxyGroups/" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

## Notes and Warnings

* **Basic Information**:
  * Returns only basic group information
  * Does not include API Proxy members or detailed settings

## Permissions

* User must have **any permission** in the project (read access)

## Related Documentation

* [Create API Proxy Group](/api-reference/api-proxy-groups/crud/create-api-proxy-group) - Create a new API Proxy Group
* [Get Environments](/api-reference/api-proxy-groups/deployment/list-environments) - Get environments for a group