Skip to main content
GET
/
videos
/
{videoId}
Get video
curl --request GET \
  --url https://rawugc.com/api/v1/videos/{videoId} \
  --header 'Authorization: Bearer <token>'
{
  "videoId": "<string>",
  "status": "pending",
  "model": "<string>",
  "prompt": "<string>",
  "creditsUsed": 123,
  "url": "<string>",
  "createdAt": 123,
  "completedAt": 123,
  "failCode": "<string>",
  "failMessage": "<string>",
  "versions": [
    {
      "videoId": "<string>",
      "version": 123,
      "url": "<string>",
      "operation": "<string>",
      "createdAt": 123
    }
  ]
}

Authorizations

Authorization
string
header
required

Use your API key from the RawUGC dashboard. Include as: Authorization: Bearer YOUR_API_KEY

Headers

RawUGC-Version
string

API version to use for this request (date string, e.g. '2026-03-06'). If omitted, uses your API key's pinned version or the latest version.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-03-06"

Path Parameters

videoId
string
required

Video identifier (vid_xxx format)

Response

Video status retrieved successfully

videoId
string

Unique video identifier (vid_xxx format)

status
enum<string>

Current generation status

Available options:
pending,
processing,
completed,
failed
model
string

Model used for generation

prompt
string

Text prompt used (if applicable)

creditsUsed
number

Credits deducted for this generation

url
string<uri>

URL to download the generated video (available when status is 'completed')

createdAt
number

Timestamp when generation was initiated

completedAt
number

Timestamp when generation completed (if finished)

failCode
string

Error code if generation failed

failMessage
string

Error message if generation failed

versions
object[]

Version chain showing edit history (captions, overlays). Present when the video has been edited.