# Retrieve paginated list of IP scopes

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

## Endpoints

`GET /dcapi/som/ip-scopes`

## Request

### 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

### 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
```

### Possible Response Codes

- **200** — HTTP code
- **204** — HTTP code

## Rate Limits

![](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.