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

# Get existing hosts

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

`GET /api/beta/hosts`

## 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
[
  {
    "connectors": [
      {
        "description": "string",
        "id": "string",
        "ipV4Address": "string",
        "ipV6Address": "string",
        "name": "string",
        "networkItemId": "string",
        "networkItemType": "HOST",
        "vpnRegionId": "string"
      }
    ],
    "description": "string",
    "domain": "string",
    "id": "string",
    "internetAccess": "string",
    "name": "string",
    "systemSubnets": [
      "string"
    ]
  }
]
```

---

Prev: [Get page of existing hosts](https://openvpn.net/cloud-docs/developer/cloudconnexa-beta-api-v0-16-0/host/get-page-of-existing-hosts.md)
Next: [Update an existing host with connectors](https://openvpn.net/cloud-docs/developer/cloudconnexa-beta-api-v0-16-0/host/update-an-existing-host-with-connectors.md)
Index: https://openvpn.net/cloud-docs/llms.txt