# Retrieves the screen recording configuration for remote control sessions

Returns the screen recording settings for remote control sessions, including whether recording is enabled, frame rate, codec type, storage size limits, color quality, and whether authenticated video download is required.

## Endpoint

`GET /dcapi/tools/remoteControl/screenRecording`

## Request

### Request URL

`https://{server-hostname}:8383/dcapi/tools/remoteControl/screenRecording`

### Scope

`RemoteControl.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Accept** `string` — Mandatory: `application/json`

### Sample Request

```curl
curl --request GET \
  --url https://appdomain/dcapi/tools/remoteControl/screenRecording \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response

### HTTP 200

Response body: `application/json`

| Attribute | Type | Description |
|---|---|---|
| isScreenRecEnabled | integer | Screen recording: 0=Disabled, 1=Enabled |
| framesPerSec | integer | Recording frame rate |
| codecType | integer | Video codec type identifier |
| colorQuality | integer | Color quality level |
| recMaintainsSize | integer | Maximum storage size in MB for recordings. Range: 1-1000 |
| driveFreeSpace | integer | Minimum free space check: 0=Disabled, 1=Enabled |
| isAuthVideoDownload | integer | Authenticated video download: 0=Disabled, 1=Enabled |
| isNotifyUserEnabled | integer | Notify end user about recording: 0=Disabled, 1=Enabled |
| notifyMessage | string | Notification message shown to the end user during recording |

### Sample Response

```json
{
  "isNotifyUserEnabled": 1,
  "notifyMessage": "This session is being recorded.",
  "isScreenRecEnabled": 1,
  "framesPerSec": 15,
  "recMaintainsSize": 500,
  "codecType": 1,
  "driveFreeSpace": 1,
  "colorQuality": 2,
  "isAuthVideoDownload": 0
}
```

### Possible Response Codes

| Code | Type |
|---|---|
| 200 | HTTP code |

## Rate Limit

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