# Get a Recording

## Retrieve a video recording by ID

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

```json
{"openapi":"3.1.1","info":{"title":"Birdie API","version":"1.0.0"},"servers":[{"url":"https://app.birdie.so/api/v1"}],"paths":{"/videos/{video_id}":{"get":{"summary":"Retrieve a video recording by ID","description":"Returns a video object if found, otherwise a 404 error.","operationId":"getVideoById","parameters":[{"schema":{"type":"string"},"name":"video_id","in":"path","description":"The unique identifier of the video, which can be the video id (integer), video uuid, or even the video sharing-link identifier.","required":true},{"schema":{"type":"string"},"name":"Authorization","in":"header","description":"Bearer API-KEY","required":true}],"responses":{"200":{"description":"Successful response containing the video object.","content":{"application/json":{"schema":{"type":"object","required":["id","way","recorded_by","bytes","created_at","duration","processing_status","sharing_link","thumbnail_file","uuid","video_file","origin"],"properties":{"id":{"type":"integer"},"way":{"type":"string"},"recorded_by":{"type":"string"},"requested_by":{"type":"string"},"bytes":{"type":"integer"},"title":{"type":"string"},"console_logs":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"duration":{"type":"integer"},"network_logs":{"type":"string"},"processing_status":{"type":"string"},"sharing_link":{"type":"string"},"thumbnail_file":{"type":"string"},"transcription":{"type":"object","properties":{"status":{"type":"string"},"language":{"type":"string"},"summary":{"type":"string"},"transcript":{"type":"string"},"raw_file":{"type":"string"}}},"uuid":{"type":"string"},"video_file":{"type":"string"},"origin":{"type":"string"}}}}}},"403":{"description":"Resource is not accessible (e.g. the video is into a private folder).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Video not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}
```