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

# Get Generation Status

> Retrieve the current status and details of a video generation job using its `generation_id`.



## OpenAPI

````yaml GET /script-to-video/genStatus/{generation_id}
openapi: 3.0.3
info:
  title: TruGen Developer Platform API
  version: 1.0.0
  description: OpenAPI specification for MCP endpoint
servers:
  - url: https://api.trugen.ai/v1
security: []
paths:
  /script-to-video/genStatus/{generation_id}:
    get:
      summary: Get Generation Status
      description: >-
        Retrieve the current status and details of a video generation job using
        its `generation_id`.
      operationId: getGenStatus
      parameters:
        - name: generation_id
          in: path
          required: true
          description: The unique identifier of the video generation job.
          schema:
            type: string
            example: 529fb61c-da5d-4b2d-9d49-b612deede60f
      responses:
        '200':
          description: Generation job details retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  actual_time:
                    type: number
                    description: The actual time taken to generate the video in seconds.
                    example: 0
                  avatar_id:
                    type: string
                    description: The ID of the avatar used for video generation.
                    example: c5b563de
                  callback_url:
                    type: string
                    description: >-
                      The callback URL provided when the generation was
                      initiated.
                    example: https://your-app.com/webhook/video-status
                  created_at:
                    type: string
                    format: date-time
                    description: Timestamp when the generation job was created.
                    example: '2026-04-20T15:50:48.501917Z'
                  estimated_time:
                    type: number
                    description: Estimated duration of the video in seconds.
                    example: 2.09
                  generation_id:
                    type: string
                    description: The unique identifier of this generation job.
                    example: 529fb61c-da5d-4b2d-9d49-b612deede60f
                  model_name:
                    type: string
                    description: The TTS model used for audio synthesis.
                    example: eleven_turbo_v2_5
                  modified_at:
                    type: string
                    format: date-time
                    description: Timestamp when the generation job was last updated.
                    example: '2026-04-20T15:51:47.429158Z'
                  provider_name:
                    type: string
                    description: The TTS provider used for audio synthesis.
                    example: elevenlabs
                  script:
                    type: string
                    description: The text script used to generate the video.
                    example: Hello, This is team trugen
                  status:
                    type: string
                    description: >-
                      Current status of the generation job. Possible values:
                      `processing`, `completed`, `failed`.
                    example: failed
                  video_name:
                    type: string
                    description: >-
                      The name of the generated video file. Empty if not yet
                      completed.
                    example: ''
                  video_url:
                    type: string
                    description: >-
                      The URL of the generated video. Empty if not yet
                      completed.
                    example: ''
                  voice_id:
                    type: string
                    description: The voice ID used for audio narration.
                    example: FGY2WhTYpPnrIDTdsKH5
              example:
                actual_time: 0
                avatar_id: c5b563de
                callback_url: https://your-app.com/webhook/video-status
                created_at: '2026-04-20T15:50:48.501917Z'
                estimated_time: 2.09
                generation_id: 529fb61c-da5d-4b2d-9d49-b612deede60f
                model_name: eleven_turbo_v2_5
                modified_at: '2026-04-20T15:51:47.429158Z'
                provider_name: elevenlabs
                script: Hello, This is team trugen
                status: failed
                video_name: ''
                video_url: ''
                voice_id: FGY2WhTYpPnrIDTdsKH5
        '401':
          description: Unauthorized – invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              example:
                error: 'Unauthorized: not a valid authorization api key'
        '404':
          description: Generation job not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              example:
                error: Generation not found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              example:
                error: Failed to retrieve generation status
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````