Skip to main content
GET
/
recordings
/
{recording_id}
recordings/:id
curl --request GET \
  --url https://api.daily.co/v1/recordings/{recording_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "0cb313e1-211f-4be0-833d-8c7305b19902",
  "start_ts": 1548789650,
  "status": "finished",
  "max_participants": 2,
  "duration": 277,
  "share_token": "TivXjlD22QQt",
  "s3key": "mydomain/test-recording-room/11245260397",
  "mtgSessionId": "257764e6-c74e-4c30-944a-a887a03173a3"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
recording_id
string
required

Response

200

​
id
string

A unique, opaque ID for this object. You can use this ID in API calls, and in paginated list operations.

Example:

"0cb313e1-211f-4be0-833d-8c7305b19902"

​
room_name
string

The name of the room.

​
start_ts
integer

When the recording started. This is a unix timestamp (seconds since the epoch).

Example:

1548789650

​
status
enum<string>
Available options:
finished,
in-progress,
canceled
Example:

"finished"

​
max_participants
integer

The maximum number of participants that were ever in this room together during the meeting session that was recorded.

Example:

2

​
duration
integer

How many seconds long the recording is, approximately. This property is not returned for recordings that are in-progress.

Example:

277

​
share_token
string

Deprecated.

Example:

"TivXjlD22QQt"

​
s3key
string

The S3 Key associated with this recording.

Example:

"mydomain/test-recording-room/11245260397"

​
mtgSessionId
string

The meeting session ID for this recording.

Example:

"257764e6-c74e-4c30-944a-a887a03173a3"

​
tracks
object[]

If the recording is a raw-tracks recording, a tracks field will be provided. If role permissions have been removed, the tracks field may be null.