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

## Endpoints

`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

- **Accept** `string` — **Mandatory**
  - `application/json`
- **Content-Type** `string` — **Mandatory**
  - `application/json`

### Query Parameters

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

`JSON Object`

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

## Possible Response Codes

- **200** `HTTP 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"
}
```