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

# Retrieve the status of a motion graphics video

> Retrieve the export status, details, and output URLs for a generated video job using its ID.



## OpenAPI

````yaml GET /videos/{video_id}
openapi: 3.1.0
info:
  version: 1.0.0
  title: Hera.Video API
  description: API for motion graphics video generation
servers:
  - url: https://api.hera.video/v1
security: []
paths:
  /videos/{video_id}:
    get:
      summary: Get the status of a motion graphics video
      description: >-
        Retrieve the export status, details, and output URLs for a generated
        video job using its ID.
      parameters:
        - schema:
            type: string
            description: The unique video/job ID returned when creating the job.
          required: true
          description: The unique video/job ID returned when creating the job.
          name: video_id
          in: path
      responses:
        '200':
          description: Full export status and list of outputs for the specified video/job.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetVideoResponse'
        '404':
          description: No video/job found with the specified ID.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Video/job not found
                required:
                  - error
      security:
        - ApiKeyAuth: []
components:
  schemas:
    GetVideoResponse:
      type: object
      properties:
        video_id:
          type: string
          description: Unique ID of this job/video.
          example: vid_abcde12345
        project_url:
          type: string
          description: Optional user interface URL for this project.
        status:
          $ref: '#/components/schemas/ExternalExportStatusEnum'
        outputs:
          type: array
          items:
            $ref: '#/components/schemas/ExportStatusEntry'
          description: Detailed export output statuses for each configuration requested.
      required:
        - video_id
        - status
        - outputs
      description: Complete status object and output info for a generated video job.
    ExternalExportStatusEnum:
      type: string
      enum:
        - in-progress
        - success
        - failed
      description: High-level status of the export job (in-progress, success, failed).
    ExportStatusEntry:
      type: object
      properties:
        status:
          allOf:
            - $ref: '#/components/schemas/ExternalExportStatusEnum'
            - description: Status of this export output (in-progress, success, or failed).
        file_url:
          type: string
          nullable: true
          description: >-
            URL to download or view the exported file if succeeded, or null if
            not applicable.
        config:
          allOf:
            - $ref: '#/components/schemas/ExternalExportConfig'
            - description: Configuration details for this export output.
        error:
          type: string
          description: Error message (if status is 'failed').
      required:
        - status
        - config
      description: Status information for an individual export output.
    ExternalExportConfig:
      type: object
      properties:
        format:
          $ref: '#/components/schemas/ExternalExportFormatEnum'
        aspect_ratio:
          $ref: '#/components/schemas/ExternalExportAspectRatioEnum'
        fps:
          anyOf:
            - type: string
              enum:
                - '24'
            - type: string
              enum:
                - '25'
            - type: string
              enum:
                - '30'
            - type: string
              enum:
                - '60'
          description: Frames per second for this export output.
        resolution:
          $ref: '#/components/schemas/ExternalExportResolutionEnum'
      required:
        - format
        - aspect_ratio
        - fps
        - resolution
      description: >-
        Configuration for an export output. Defines the file format, aspect
        ratio, frame rate, and resolution.
    ExternalExportFormatEnum:
      type: string
      enum:
        - mp4
        - prores
        - webm
        - gif
      description: Output format for this export (e.g. mp4, prores, webm, gif).
    ExternalExportAspectRatioEnum:
      type: string
      enum:
        - '16:9'
        - '9:16'
        - '1:1'
        - '4:5'
      description: Aspect ratio for this export (e.g. '16:9', '9:16', '1:1', '4:5').
    ExternalExportResolutionEnum:
      type: string
      enum:
        - 360p
        - 480p
        - 720p
        - 1080p
        - 4k
      description: Resolution for this export output (e.g. '1080p', '720p').
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your API key for authenticating requests.

````