# Retrieve paginated list of IP scopes

Retrieves a paginated list of all IP scopes for the customer.

## Endpoint

`GET /dcapi/som/ip-scopes`

## Request URL

`https://`[*{serverurl}*](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)`/dcapi/som/ip-scopes`

## Scope

`DesktopCentralCloud.SOM.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** (`string`, Mandatory): `application/allIPScopeDetails.v1+json`

### Query Parameters

- **page** (`integer`, Optional): Specifies the page number to retrieve. Default is 1.
- **size** (`string`, Optional): Specifies the maximum number of items to return per page. The default value is 25. A maximum of 1000 records can be retrieved in a single request.

## Sample Request

```curl
curl --request GET \
  --url https://appdomains/dcapi/som/ip-scopes \
  --header 'Accept: application/allIPScopeDetails.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

#### Response Body — application/json

- `JSON Object`
  - **ipScopes** (`JSON Array`): Array of IP scope objects. Each object contains the boundary definition (range or subnet) and its associated remote office.

#### Response Headers

- **X-Total-Count** (`string`): Total number of IP scopes available.

## Sample Response: HTTP 200

IP scopes found

```json
{
  "ipScopes": [
    {
      "boundaryID": 1,
      "description": "HQ Network Range",
      "remoteOfficeID": 101,
      "ipScopeType": "range",
      "startIPAddress": "192.168.1.1",
      "endIPAddress": "192.168.1.254"
    }
  ]
}
```

## Sample Response: HTTP 204

```text
204 No Content
```

![ ](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 30 | **Lock period:** 5 minutes

Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.