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

Get video generation status

GET
/v1/video-generations/{generationId}
Returns the latest status, progress, source summary, and available outputs for one generation.

Request

Path Params

Responses

🟢200OK
application/json
Generation status.
Bodyapplication/json

🟠401Unauthorized
🟠404Record Not Found
🟠429
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v1/video-generations/'
Response Response Example
200 - Generation status
{
    "id": "job_01HXAMPLE",
    "status": "generating",
    "statusDetail": "Generating video scenes.",
    "progress": 42,
    "input": "AI video workflow automation",
    "video": {
        "durationTargetSeconds": 45,
        "aspectRatio": "9:16",
        "resolution": "1080p",
        "qualityTier": "balanced"
    },
    "creative": {
        "format": "newsExplainer"
    },
    "resultUrl": null,
    "errorCode": null,
    "errorMessage": null,
    "createdAt": "2026-05-13T10:00:00.000Z",
    "updatedAt": "2026-05-13T10:03:00.000Z",
    "completedAt": null
}
Modified at 2026-05-24 15:07:59
Previous
Create a video generation
Next
Get completed generation result
Built with