---
title: "Get Job Status"
method: GET
path: "/api/v1/thumbnails/jobs/{job_id}"
tags: ["thumbnails"]
---

# Get Job Status

`GET /api/v1/thumbnails/jobs/{job_id}`

## Request

- Base URL: `https://docs.thedrive.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.thedrive.ai/api/v1/thumbnails/jobs/{job_id}`
- Auth: none declared

Get the status of an async thumbnail generation job.

## Path parameters

- `job_id` string, required

## Headers

- `X-API-Key` string

## Response `200`

Successful Response

- JobStatusResponse: Response for job status queries.
  - `job_id` string, required: Unique job identifier
  - `status` 'pending' | 'processing' | 'completed' | 'failed', required: Job processing status.
  - `progress` integer, nullable: Progress percentage
  - `result` ThumbnailResponse: Response for a completed thumbnail generation.
    - `success` boolean
    - `job_id` string, required: Unique job identifier
    - `status` 'pending' | 'processing' | 'completed' | 'failed': Job processing status.
    - `thumbnail_url` string, nullable: URL to the thumbnail image
    - `thumbnail_base64` string, nullable: Base64-encoded thumbnail (if response_type='base64')
    - `metadata` ThumbnailMetadata, required: Metadata about the generated thumbnail.
      - `original_filename` string, required: Original filename
      - `file_type` string, required: File extension (e.g., 'pdf', 'png')
      - `file_category` 'image' | 'video' | 'pdf' | 'document' | 'spreadsheet' | 'presentation' | 'markdown' | 'code' | 'text' | 'ebook' | 'unsupported', required: Supported file categories for thumbnail generation.
      - `file_size` integer, required: Original file size in bytes
      - `mime_type` string, required: MIME type of the original file
      - `thumbnail_width` integer, required: Thumbnail width in pixels
      - `thumbnail_height` integer, required: Thumbnail height in pixels
      - `created_at` string, date-time, required: When the thumbnail was created
  - `error` string, nullable: Error message if job failed
  - `created_at` string, date-time, required: When the job was created
  - `completed_at` string, date-time, nullable: When the job completed

## Other responses

- `404`: Job not found
- `422`: Validation Error

---

[API](https://skmtc.dev/thedrive/apis/the-drive-ai-api.md) · [All operations](https://skmtc.dev/thedrive/apis/the-drive-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thedrive/apis/the-drive-ai-api/revisions/ee4e32647ebf?raw)