# Retrieve paginated list of IP scopes

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

## Endpoint

`GET /dcapi/som/ip-scopes`

## Request Details

### Request URL

`https://{server-hostname}:8383/dcapi/som/ip-scopes`

### Scope

`SOM.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** `string` — Mandatory
  - `application/allIPScopeDetails.v1+json`

## Sample Request

```curl
curl --request GET \
  --url https://appdomain/dcapi/som/ip-scopes \
  --header 'Accept: application/allIPScopeDetails.v1+json' \
  --header 'Authorization:  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.

## Possible Response Codes

- **200** `HTTP code`
- **204** `HTTP code`

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

## API Rate Limit

**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.