# Retrieve the details of a specific Windows Lockdown (Kiosk) Policy

Get the lockdown policy details

## Endpoints

GET `/api/mdm/profiles/lockdown/policies/{policy_id}`

## Request URL

`https://{server-hostname}:8383/api/mdm/profiles/lockdown/policies/{policy_id}`

## Scope

`MDMDeviceMgmt.READ`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

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

### Path Parameters

- **policy_id** `string` — **Mandatory**: Unique identifier of the lockdown policy. Obtain from the [Create Lockdown Policy](https://www.manageengine.com/products/desktop-central/help/api/onpremise/windows-create-lockdown-policy.html) response

## Sample Request

```curl
curl --request GET \
  --url https://appdomain/api/mdm/profiles/lockdown/policies/{policy_id} \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP code 200

#### Response Body — application/json

- `JSON Object`
  - **policy_id** `string`: Unique ID of the lockdown policy
  - **configuration** `JSON Object`: Lockdown policy configuration settings
  - **appconfig** `JSON Object`: Container for allowed apps configuration

## Possible Response Codes

- **200** `HTTP code`

## Sample Response: HTTP 200

### Full lockdown policy details (Multi app)

```json
{
  "policy_id": "9007199254741003",
  "configuration": {
    "show_taskbar": true,
    "group_display_name": "Camera",
    "auto_distribute_apps": true,
    "auto_logon_app": "Microsoft.WindowsCamera_8wekyb3d8bbwe!App",
    "kiosk_type": "1",
    "create_user": true,
    "associated_user": "Kiosk",
    "explorer_restriction": "5"
  },
  "appconfig": {
    "allowed_apps": [
      {
        "group_display_name": "Camera",
        "app_type": "1",
        "app_identifier": "Microsoft.WindowsCamera_8wekyb3d8bbwe!App",
        "is_background_app": false
      },
      {
        "app_type": "2",
        "app_identifier": "%windir%\\system32\\calc.exe",
        "is_background_app": false
      },
      {
        "app_type": "2",
        "app_identifier": "%windir%\\system32\\cmd.exe",
        "is_background_app": true
      }
    ]
  }
}
```

### Full lockdown Edge policy details

```json
{
  "policy_id": "9007199254741003",
  "configuration": {
    "show_taskbar": true,
    "auto_distribute_apps": false,
    "webclip_properties": {
      "webclip_url": "%windir%\\system32\\calc.exe",
      "webclip_policy_id": "1",
      "webclip_name": "t1"
    },
    "edge_kiosk_type": "1",
    "kiosk_type": "3",
    "create_user": true,
    "edge_idle_timeout": "0",
    "associated_user": "Kiosk",
    "explorer_restriction": "1"
  },
  "appconfig": {
    "allowed_apps": [
      {
        "app_type": "2",
        "app_identifier": "%ProgramFiles(x86)%\\Microsoft\\Edge\\Application\\msedge.exe",
        "is_background_app": false
      }
    ]
  }
}
```

### Full lockdown Single App policy details

```json
{
  "policy_id": "9007199254741003",
  "configuration": {
    "show_taskbar": true,
    "auto_distribute_apps": false,
    "kiosk_type": "2",
    "create_user": true,
    "associated_user": "Kiosk",
    "explorer_restriction": "1"
  },
  "appconfig": {
    "allowed_apps": [
      {
        "group_display_name": "Calculator",
        "app_type": "1",
        "app_identifier": "Microsoft.WindowsCalculator_8wekyb3d8bbwe!App",
        "is_background_app": false
      }
    ]
  }
}
```

## Rate Limit

**Duration:** 1 minute | **Threshold:** 120 | **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.