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

# List Download Jobs

> Retrieve a list of all video download jobs and their status

Retrieve paginated list of all download jobs in your account. Each entry shows download status, timestamps, and download URLs for completed jobs.

<CodeGroup>
  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.videodb.io/download",
      headers={"x-access-token": "your_api_key"},
      params={
          "page_index": 0,
          "count": 50
      }
  )

  result = response.json()
  downloads = result.get('data', {}).get('downloads', [])
  for download in downloads:
      print(f"{download['id']}: {download['name']} - {download['status']}")
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
      "https://api.videodb.io/download?page_index=0&count=50",
      {
          method: "GET",
          headers: {
              "x-access-token": "your_api_key"
          }
      }
  );

  const result = await response.json();
  const downloads = result.data?.downloads || [];
  for (const download of downloads) {
      console.log(`${download.id}: ${download.name} - ${download.status}`);
  }
  ```
</CodeGroup>

<Note>
  * Results are paginated with `page_index` and `count` parameters
  * `count` has a maximum of 5,000 items per request
  * Status can be `processing`, `done`, or `error`
  * Completed downloads include a `download_url` valid for 24 hours
</Note>

<CardGroup cols={2}>
  <Card title="Get Download Status" icon="search" href="/api-reference/downloads/get_download">
    Get detailed information for a specific download
  </Card>

  <Card title="Create Download" icon="plus" href="/api-reference/downloads/create_download">
    Start a new download job
  </Card>
</CardGroup>


## OpenAPI

````yaml GET /download
openapi: 3.0.3
info:
  title: VideoDB Server API
  description: >
    VideoDB Server API for video, audio, and image processing with AI
    capabilities.

    This API provides comprehensive video management, search, indexing, and
    AI-powered features.
  version: 1.0.0
  contact:
    name: VideoDB Support
    url: https://videodb.io
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: https://api.videodb.io
    description: Production server
  - url: https://staging-api.videodb.io
    description: Staging server
security:
  - ApiKeyAuth: []
tags:
  - name: Authentication
    description: User authentication and API key management
  - name: Collections
    description: Collection management operations
  - name: Videos
    description: Video upload, processing, and management
  - name: Audio
    description: Audio management operations
  - name: Images
    description: Image management operations
  - name: Search
    description: Content search and indexing
  - name: AI Generation
    description: AI-powered content generation
  - name: Billing
    description: Billing and usage management
  - name: RTStream
    description: Real-time streaming operations
  - name: Utilities
    description: Utility endpoints
  - name: Meeting
    description: Meeting recording and management
  - name: Capture
    description: Capture session management for recording streams
  - name: Editor
    description: Timeline editor operations
  - name: Transcode
    description: Media transcoding operations
  - name: Assets
    description: Cross-collection asset listing
paths:
  /download:
    get:
      summary: List download entries
      parameters:
        - name: page_index
          in: query
          schema:
            type: integer
            example: 0
        - name: count
          in: query
          schema:
            type: integer
            maximum: 5000
            example: 50
      responses:
        '200':
          description: List of downloads
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      downloads:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              example: download-12345
                            name:
                              type: string
                              example: video_download.mp4
                            status:
                              type: string
                              enum:
                                - processing
                                - done
                                - error
                              example: done
                            created_at:
                              type: string
                              format: date-time
                            download_url:
                              type: string
                              example: https://example.com/download/video.mp4
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-access-token
      description: API key for authentication (sk-xxx format)

````