Get a Recording

This is the method to request a single recording if you have its identifier or its sharing link code.

Retrieve a video recording by ID

get

Returns a video object if found, otherwise a 404 error.

Path parameters

video_idstringRequired

The unique identifier of the video, which can be the video id (integer), video uuid, or even the video sharing-link identifier.

Header parameters

AuthorizationstringRequired

Bearer API-KEY

Responses

200

Successful response containing the video object.

application/json

idintegerRequired

waystringRequired

recorded_bystringRequired

requested_bystringOptional

bytesintegerRequired

titlestringOptional

console_logsstringOptional

created_atstring · date-timeRequired

durationintegerRequired

network_logsstringOptional

processing_statusstringRequired

sharing_linkstringRequired

thumbnail_filestringRequired

uuidstringRequired

video_filestringRequired

originstringRequired

403

Resource is not accessible (e.g. the video is into a private folder).

application/json

404

Video not found.

application/json

get

/videos/{video_id}

HTTPcURLJavaScriptPython

GET /api/v1/videos/{video_id} HTTP/1.1
Host: app.birdie.so
Authorization: text
Accept: */*

{
  "id": 1,
  "way": "text",
  "recorded_by": "text",
  "requested_by": "text",
  "bytes": 1,
  "title": "text",
  "console_logs": "text",
  "created_at": "2026-02-27T17:13:35.509Z",
  "duration": 1,
  "network_logs": "text",
  "processing_status": "text",
  "sharing_link": "text",
  "thumbnail_file": "text",
  "transcription": {
    "status": "text",
    "language": "text",
    "summary": "text",
    "transcript": "text",
    "raw_file": "text"
  },
  "uuid": "text",
  "video_file": "text",
  "origin": "text"
}