---
title: Get existing access groups
canonical: https://openvpn.net/cloud-docs/developer/cloudconnexa-beta-api-v0-16-0/access-group/get-existing-access-groups/
product: CloudConnexa Docs
---

# Get existing access groups

> **Note**
>
> Use the API pagination endpoint [Get page of existing access groups](https://openvpn.net/cloud-docs/developer/cloudconnexa-beta-api-v0-16-0/access-group/get-page-of-existing-access-groups.md)

`GET /api/beta/access-groups`

## Responses

| Status | Meaning | Description | Schema |
| --- | --- | --- | --- |
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | Inline |
| 400 | [Bad Request](https://tools.ietf.org/html/rfc7231#section-6.5.1) | Bad Request | None |
| 401 | [Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1) | Unauthorized | None |
| 403 | [Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3) | Access Forbidden | None |
| 404 | [Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4) | Not Found | None |
| 406 | [Not Acceptable](https://tools.ietf.org/html/rfc7231#section-6.5.6) | Not Acceptable | None |
| 429 | [Too Many Requests](https://tools.ietf.org/html/rfc6585#section-4) | Too Many Requests | None |
| 500 | [Internal Server Error](https://tools.ietf.org/html/rfc7231#section-6.6.1) | Internal Server Error | None |

```json
[
  {
    "defaultGroup": true,
    "description": "string",
    "destination": [
      {
        "allCovered": true,
        "children": [
          {}
        ],
        "parent": {
          "id": "string",
          "name": "string"
        },
        "type": "HOST_SERVICE"
      }
    ],
    "id": "string",
    "name": "string",
    "source": [
      {
        "allCovered": true,
        "children": [
          {}
        ],
        "parent": {
          "id": "string",
          "name": "string"
        },
        "type": "HOST"
      }
    ]
  }
]
```

---

Prev: [Get page of existing access groups](https://openvpn.net/cloud-docs/developer/cloudconnexa-beta-api-v0-16-0/access-group/get-page-of-existing-access-groups.md)
Next: [Remove destination from an existing access group](https://openvpn.net/cloud-docs/developer/cloudconnexa-beta-api-v0-16-0/access-group/remove-destination-from-an-existing-access-group.md)
Index: https://openvpn.net/cloud-docs/llms.txt