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 by ID

get

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

Authorizations

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.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://app.birdie.so/api/v1/video/{video_id}' \
  --header 'Authorization: Bearer API-KEY'

200

404

200

{
  "id": 303012,
  "way": "received",
  "recorded_by": "[e-mail]",
  "requested_by": null,
  "bytes": 6872971,
  "title": null,
  "console_logs": null,
  "created_at": "2024-12-11T17:53:47Z",
  "duration": 49333,
  "network_logs": null,
  "processing_status": "pending",
  "sharing_link": "https://staging.birdie.so/w3u2Oay",
  "thumbnail_file": "https://birdie-paris.s3.eu-west-3.amazonaws.com/videos/e4bf56a2/fYGi3POcLh1VBzkwoKzDmPzGpLmtLNnv.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD...",
  "transcription": {
    "status": "completed",
    "language": "rw-RW",
    "summary": null,
    "transcript": null
  },
  "uuid": "5a83a5b9-e90f-4436-958d-ec73b32c74e8",
  "video_file": "https://birdie-paris.s3.eu-west-3.amazonaws.com/videos/e4bf56a2/2RBolLRxS4qsYE53LBmkJj1D5KZg1VCW.mp4?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD...",
  "origin": "intercom"
}

Successful response containing the video object.