> ## Documentation Index
> Fetch the complete documentation index at: https://docs.genviral.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Studio Video

> Poll canonical video generation status by `video_id`.

Returns status for a Studio video job in the authenticated key scope.

## Path Parameters

<ParamField path="videoId" type="string" required>
  Video UUID returned by `POST /api/partner/v1/studio/videos/generate`.
</ParamField>

## Status Values

* `processing`
* `succeeded`
* `failed`

## Example

```bash theme={null}
curl --request GET \
  --url 'https://www.genviral.io/api/partner/v1/studio/videos/22222222-2222-2222-2222-222222222222' \
  --header 'Authorization: Bearer <token>'
```

<ResponseExample>
  ```json Response theme={null}
  {
    "ok": true,
    "code": 200,
    "message": "Video status retrieved",
    "data": {
      "video_id": "22222222-2222-2222-2222-222222222222",
      "prediction_id": "pred_abc123",
      "model_id": "openai/sora-2",
      "provider": "fal",
      "status": "succeeded",
      "output_url": "https://cdn.example.com/videos/video-22222222.mp4",
      "error": null,
      "created_at": "2026-02-19T10:20:30.000Z",
      "context": "partner_api",
      "source": "partner_api_studio"
    }
  }
  ```
</ResponseExample>

## Error Responses

* `404 video_not_found`
* `422 invalid_path`
* `401` - authentication failed (missing/invalid/revoked token)