> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# getRecordings

> getRecordings method for the RoomSession class.

### getRecordings

* **getRecordings**(): `Promise<{ recordings: RoomSessionRecording}>` - See [RoomSessionRecording documentation](/docs/browser-sdk/v3/js/reference/video/room-session-recording) for more details.

Obtains a list of recordings for the current room session. To download the actual mp4 file, please use the [REST API](/docs/apis).

#### Returns

`Promise<{ recordings: RoomSessionRecording}>` - See [RoomSessionRecording documentation](/docs/browser-sdk/v3/js/reference/video/room-session-recording) for more details.

#### Permissions

* `room.recording`

You need to specify the permissions when [creating the Video Room Token](/docs/apis/rest/video/room-tokens/create-room-token) on the server side.

#### Example

```javascript
const recs = await roomSession.getRecordings();
if (recs.recordings.length > 0) {
  console.log(recs.recordings[0].id, recs.recordings[0].duration);
}
```

From your server, you can obtain the mp4 file using the [REST API](/docs/apis):

```bash
curl --request GET \
     --url https://<yourspace>.signalwire.com/api/video/room_recordings/<recording_id> \
     --header 'Accept: application/json' \
     --header 'Authorization: Basic <your API token>'
```

> getRecordings method for the RoomSession class.