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

# Get Avatar Video Status

> Get video information and status by video ID

Retrieve the status and details of an avatar video by its project ID. Use this endpoint to check if video generation is complete and get the video URL.

## Example Usage

```bash theme={null}
curl --request GET \
  --url 'https://api.jogg.ai/v2/avatar_video/vid_abc123' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Related Guides

<CardGroup cols={2}>
  <Card title="Create Avatar Videos Guide" href="/api-reference/v2/API Documentation/CreateAvatarVideos">
    Learn how to create avatar videos
  </Card>
</CardGroup>


## OpenAPI

````yaml GET /v2/avatar_video/{id}
openapi: 3.0.1
info:
  title: JoggAI OpenAPI v2
  description: >
    JoggAI OpenAPI v2 provides a comprehensive suite of endpoints for creating
    and managing AI-powered video content.


    ## Authentication

    All API requests require authentication using an API key provided in the
    `x-api-key` header.


    ## Base URL

    Production: https://api.jogg.ai/v2


    ## Rate Limiting

    API calls are subject to rate limiting based on your subscription plan.


    ## Error Handling

    All endpoints return standard HTTP status codes along with detailed error
    messages in the response body.
  version: 2.0.0
  license:
    name: MIT
servers:
  - url: https://api.jogg.ai
    description: Production server
security:
  - apiKeyAuth: []
tags:
  - name: Video
    description: Video creation and management operations
  - name: Avatar
    description: Avatar management and creation operations
  - name: Voice
    description: Voice and timbre management operations
  - name: Asset
    description: Asset management including music, scripts, and uploads
  - name: Template
    description: Template management operations
  - name: Product
    description: Product management operations
  - name: User
    description: User account operations
  - name: Webhook
    description: Webhook endpoint management for event notifications
paths:
  /v2/avatar_video/{id}:
    get:
      tags:
        - Video
      summary: Retrieve talking avatar video
      description: Get video information and status by video ID
      parameters:
        - name: id
          in: path
          required: true
          description: Video ID from video creation endpoint
          schema:
            type: string
            example: video_123456
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/BaseResponse'
                  - type: object
                    properties:
                      data:
                        type: object
                        properties:
                          video_id:
                            type: string
                            description: Unique video identifier
                            example: video_123456
                          status:
                            type: string
                            description: Video processing status
                            enum:
                              - pending
                              - processing
                              - completed
                              - failed
                            example: completed
                          video_url:
                            type: string
                            description: >-
                              Video file URL (available when status is
                              completed)
                            format: uri
                            example: https://example.com/videos/video_123456.mp4
                          cover_url:
                            type: string
                            description: >-
                              Video cover image URL (available when status is
                              completed)
                            format: uri
                            example: https://example.com/covers/video_123456.jpg
                          created_at:
                            type: integer
                            description: Video creation timestamp (Unix timestamp)
                            example: 1640995200
components:
  schemas:
    BaseResponse:
      type: object
      required:
        - code
        - msg
      properties:
        code:
          type: integer
          description: |
            Business status code:
            * 0 - Success
            * 10104 - Record not found
            * 10105 - Invalid API key
            * 18020 - Insufficient credit
            * 18025 - No permission to call APIs
            * 40000 - Parameter error
            * 50000 - System error
          example: 0
        msg:
          type: string
          description: Response message
          example: Success
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication. Obtain your key from the JoggAI dashboard.

````