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

# Get existing service

`GET /api/beta/ip-services/single`

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| serviceId | query | string | true | serviceId |

## Responses

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

To perform this operation, you must be authenticated by means of one of the following methods: OAuth\_authorization

```json
{
  "config": {
    "customServiceTypes": [
      {
        "icmpType": [
          {
            "lowerValue": 0,
            "upperValue": 0,
            "value": 0
          }
        ],
        "port": [
          {
            "lowerValue": 0,
            "upperValue": 0,
            "value": 0
          }
        ],
        "protocol": "ICMP"
      }
    ],
    "serviceTypes": [
      "ANY"
    ]
  },
  "description": "string",
  "id": "string",
  "name": "string",
  "networkItemId": "string",
  "networkItemType": "HOST",
  "routes": [
    {
      "description": "string",
      "id": "string",
      "parentRouteId": "string",
      "subnet": "string",
      "type": "IP_V4"
    }
  ],
  "type": "IP_SOURCE"
}
```

---

Prev: [Delete an existing service](https://openvpn.net/cloud-docs/developer/cloudconnexa-beta-api-v0-16-0/ip-service/delete-an-existing-service.md)
Next: [Get page of existing IP services](https://openvpn.net/cloud-docs/developer/cloudconnexa-beta-api-v0-16-0/ip-service/get-page-of-existing-ip-services.md)
Index: https://openvpn.net/cloud-docs/llms.txt