Catchups.ai Video creation API
  1. Video Generations
  • Account
    • Get authenticated account summary
      GET
  • Video Generations
    • List video generations
      GET
    • Create a video generation
      POST
    • Get video generation status
      GET
    • Get completed generation result
      GET
    • Cancel a video generation
      POST
  • Research
    • Create a researched video generation
      POST
  1. Video Generations

List video generations

GET
/v1/video-generations
Returns a paginated list of video generation jobs visible to the authenticated caller.

Request

Query Params

Responses

🟢200OK
application/json
Recent generations scoped to the caller.
Bodyapplication/json

🟠401Unauthorized
🟠429
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v1/video-generations?limit=undefined&offset=undefined'
Response Response Example
200 - Recent generations
{
    "items": [
        {
            "id": "job_01HXAMPLE",
            "status": "completed",
            "statusDetail": "Generation completed.",
            "progress": 100,
            "input": "AI video workflow automation",
            "video": {
                "durationTargetSeconds": 45,
                "aspectRatio": "9:16",
                "resolution": "1080p",
                "qualityTier": "balanced"
            },
            "creative": {
                "format": "newsExplainer"
            },
            "resultUrl": "/v1/video-generations/job_01HXAMPLE/result",
            "errorCode": null,
            "errorMessage": null,
            "createdAt": "2026-05-13T10:00:00.000Z",
            "updatedAt": "2026-05-13T10:08:00.000Z",
            "completedAt": "2026-05-13T10:08:00.000Z"
        }
    ],
    "limit": 30,
    "offset": 0
}
Modified at 2026-05-24 15:07:59
Previous
Get authenticated account summary
Next
Create a video generation
Built with