Skip to main content
GET
/
videos
List videos
curl --request GET \
  --url https://rawugc.com/api/v1/videos \
  --header 'Authorization: Bearer <token>'
{
  "videos": [
    {
      "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
        }
      ]
    }
  ],
  "pagination": {
    "total": 123,
    "page": 123,
    "pageSize": 123,
    "hasMore": true
  }
}

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"

Query Parameters

status
enum<string>

Filter by video status

Available options:
pending,
processing,
completed,
failed
limit
integer
default:50

Number of videos per page

Required range: 1 <= x <= 100
page
integer
default:1

Page number

Required range: x >= 1

Response

Videos retrieved successfully

videos
object[]
pagination
object