# Retrieves BitLocker Recovery Keys.

This API lists BitLocker recovery key information for all computers. Results can be filtered by domain, computer name, or key protector ID.

## Endpoint

`GET /api/1.4/bitlocker/recoverykeydetails`

## Request URL

`https://`[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)`/api/1.4/bitlocker/recoverykeydetails`

### Scope

`DesktopCentralCloud.DataEncryption.READ`

#### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

| Parameter | Type | Required | Value |
|---|---|---|---|
| Accept | string | Mandatory | `application/json` |
| Content-Type | string | Mandatory | `application/json` |

### Query Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| keyProtectorId | string | Optional | Filter Recovery Key details with Key protector Id |
| compName | string | Optional | Filter Recovery Key details with particular computer name |
| domainfilter | string | Optional | Get domain list from `api/1.4/desktop/serverproperties` |

## Sample Request

```curl
curl --request GET \
  --url https://appdomains/api/1.4/bitlocker/recoverykeydetails \
  --header 'Accept: application/json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json'
```

## Response Parameters

### HTTP Code 200

#### Response Body: application/json

| Parameter | Type | Description |
|---|---|---|
| message_type | string | Module Code |
| message_response | JSON Object | Response. |
| message_version | integer | Api Version. |
| status | integer | Status of Api call. |
| response_code | integer | Response code. |

## Sample Response: HTTP 200

```json
{
  "response_code": 200,
  "message_type": "recoverykeydetails",
  "message_response": {
    "recoverykeydetails": [
      {
        "key_protector_id": "{0977480D-C76E-4B8E-B750-123BCCCE47C}",
        "recovery_key": "223575-265432-890982-416042-399949-366960-389807",
        "drive_letter": "C:",
        "name": "SYS-1",
        "resource_id": 110707,
        "domain_netbios_name": "WORKGROUP",
        "customer_id": 1
      }
    ]
  },
  "message_version": "1.4",
  "status": "success"
}
```