> For the complete documentation index, see [llms.txt](https://emotiv.gitbook.io/cortex-library-for-mobile/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://emotiv.gitbook.io/cortex-library-for-mobile/jsonapi/queryvirtualheadsets.md).

# queryVirtualHeadsets

This method lists all the virtual headsets that were previously created by [createVirtualHeadset](/cortex-library-for-mobile/jsonapi/createvirtualheadset.md).

## Parameters

| Name        | Type     | Required | Description                                                                                    |
| ----------- | -------- | -------- | ---------------------------------------------------------------------------------------------- |
| cortexToken | `string` | yes      | A token returned by [authorize](https://emotiv.gitbook.io/cortex-api/authentication/authorize) |

## Result

The result is an array of [Virtual headset objects](/cortex-library-for-mobile/jsonapi/virtual-headset-object.md), or an empty array if there is no virtual headset.

## Example

{% tabs %}
{% tab title="Request" %}

```javascript
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "queryVirtualHeadsets",
  "params": {
      "cortexToken": "xxx"
    }
}
```

{% endtab %}

{% tab title="Response" %}

```javascript
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [{
    "battery": 3,
    "connectionType": "bluetooth",
    "cq": {
      "T7": 4,
      "T8": 4
    },
    "cqStatus": "",
    "fe": {
      "lowerFaceAction": "neutral",
      "lowerFacePower": 0,
      "upperFaceAction": "neutral",
      "upperFacePower": 0
    },
    "mc": {
      "action": "neutral",
      "power": 0
    },
    "name": "Virtual MN8",
    "ownerId": "c7f6d941-d972-496b-8504-fcc903c46f02",
    "pm": {
      "auditoryAttention": {
        "isActive": true,
        "score": 0.5
      },
      "cognitiveStress": {
        "isActive": true,
        "score": 0.5
      }
    },
    "powerOn": false,
    "preRecordedSamples": "",
    "serial": "B7BF6142",
    "type": "MN8",
    "uuid": "b7bf6142-c7ea-4e1a-a88e-9ca0aa6b3f1c"
  }]
}
```

{% endtab %}
{% endtabs %}