---
title: "Get All Statuses"
method: GET
path: "/status"
tags: ["Status"]
---

# Get All Statuses

`GET /status`

Retrieve the status of all image processing jobs.

**Pagination (Highly Recommended):**
For better performance and to handle large numbers of statuses, pagination is highly recommended. Enable pagination by setting `paginated=true`. When pagination is enabled:
  - Use the `limit` parameter to control the number of results per page (default: 50, maximum: 100)
  - Use the `cursor` parameter to retrieve subsequent pages
  - The response will include pagination metadata with `next_cursor` and `has_next_page` fields

**Non-Paginated Response:**
When `paginated=false` (default) or omitted, the endpoint returns all statuses **up to 7 days old** as a simple array. This may be slow or fail for accounts with many statuses.

## Query parameters

- `paginated` boolean
- `limit` integer
- `cursor` string

## Response `200`

Statuses of all processes. The response format depends on whether pagination is enabled.

- union
  - StatusResponse[] — Non-paginated response (when `paginated=false` or omitted)
    - `status` 'requested' | 'accepted' | 'initializing' | 'preprocessing' | 'processing' | 'postprocessing' | 'complete' | 'canceling' | 'canceled' | 'failed'
    - `progress` number — Total progress of the request in percentage
    - `estimates` RequestEstimates — Lower and upper bound estimates
      - `cost` integer[] — In credits
      - `time` integer[] — In seconds, assuming an empty queue, starting from the time the source video has been received
    - `outputSize` string
    - `averageFps` number — Average processing speed of each node
    - `combinedFps` number — Combined processing speed of all nodes
    - `message` string
    - `processingJobs` object[] — Processing state for each chunk
      - `chunkId` string, uuid
      - `chunkIndex` integer — Index of the chunk starting from 0
      - `taskIndex` integer — Index of a chunk's enhancement task starting from 0
      - `status` 'queued' | 'processing' | 'complete' | 'canceled' | 'failed'
      - `gpuUtilization` number — In percentage
      - `gpuMemoryUtilization` number — In percentage
      - `sampleCount` integer — The number of latest processing stat records used in the average calculation
      - `currentFrame` integer
      - `expectedOutputFrames` integer — This value and currentFrame is used to calculate the progress %
      - `latestLogTs` integer — Timestamp of the latest stat record in milliseconds since UTC epoch
      - `currentSize` integer — In bytes
      - `fps` number — Processing speed of the node
      - `progress` number — In percentage
    - `download` EnhancedDownloadSignedUrlResponse — Signed download URL to the enhanced video file.
      - `url` string
      - `expiresIn` integer — TTL in milliseconds
      - `expiresAt` integer — Time in milliseconds since UTC epoch
  - PaginatedStatusesResponse
    - `data` StatusResponse[], required — Array of status responses for the current page.
      - `status` 'requested' | 'accepted' | 'initializing' | 'preprocessing' | 'processing' | 'postprocessing' | 'complete' | 'canceling' | 'canceled' | 'failed'
      - `progress` number — Total progress of the request in percentage
      - `estimates` RequestEstimates — Lower and upper bound estimates
        - `cost` integer[] — In credits
        - `time` integer[] — In seconds, assuming an empty queue, starting from the time the source video has been received
      - `outputSize` string
      - `averageFps` number — Average processing speed of each node
      - `combinedFps` number — Combined processing speed of all nodes
      - `message` string
      - `processingJobs` object[] — Processing state for each chunk
        - `chunkId` string, uuid
        - `chunkIndex` integer — Index of the chunk starting from 0
        - `taskIndex` integer — Index of a chunk's enhancement task starting from 0
        - `status` 'queued' | 'processing' | 'complete' | 'canceled' | 'failed'
        - `gpuUtilization` number — In percentage
        - `gpuMemoryUtilization` number — In percentage
        - `sampleCount` integer — The number of latest processing stat records used in the average calculation
        - `currentFrame` integer
        - `expectedOutputFrames` integer — This value and currentFrame is used to calculate the progress %
        - `latestLogTs` integer — Timestamp of the latest stat record in milliseconds since UTC epoch
        - `currentSize` integer — In bytes
        - `fps` number — Processing speed of the node
        - `progress` number — In percentage
      - `download` EnhancedDownloadSignedUrlResponse — Signed download URL to the enhanced video file.
        - `url` string
        - `expiresIn` integer — TTL in milliseconds
        - `expiresAt` integer — Time in milliseconds since UTC epoch
    - `pagination` PaginationMetadata, required
      - `next_cursor` string — The cursor to use for retrieving the next page of results. Omitted if there are no more pages.
      - `has_next_page` boolean, required — Indicates whether there are more pages of results available.

## Other responses

- `400` — The request contains malformed data in the body, path, or query parameters.
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too many requests hit the API too quickly. A backoff (e.g. exponential) is recommended for your requests.
- `500` — Internal server error

---

[API](https://skmtc.net/topazlabs/apis/image-api.md) · [All operations](https://skmtc.net/topazlabs/apis/image-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topazlabs/image-api/revisions/7610937217a4/schema)