---
title: "Get job status"
method: POST
path: "/job/status"
---

# Get job status

`POST /job/status`

Returns timing, success state, output, and progress for a specific job.

## Query parameters

- `jobid` number
- `_async` boolean

## Headers

- `Prefer` 'respond-async'

## Request body

- JobStatusRequest
  - `jobid` number — Numeric identifier of the job to query, as returned from an async call.
  - `_async` boolean — Run the command asynchronously. Returns a job id immediately.

## Response `200`

Detailed status for a background job, including timing, success flag, and optional output.

- object
  - `executeId` string, required — Identifier for this rclone process.
  - `finished` boolean, required — True once the job has completed.
  - `duration` number, required — Execution time in seconds.
  - `endTime` string, required — Timestamp when the job finished. (e.g. '2025-12-26T18:50:20.528746884+01:00')
  - `error` string, required — Error message, or empty string on success.
  - `id` number, required — Job identifier.
  - `startTime` string, required — Timestamp when the job started. (e.g. '2025-12-24T18:50:20.5281314+01:00')
  - `success` boolean, required — True if the job completed successfully.
  - `output` unknown
  - `progress` unknown

## Other responses

- `202` — Request accepted for async processing. Poll /job/status with the returned jobid.
- `4XX` — Any error response (HTTP 4xx/5xx)
- `5XX` — Any error response (HTTP 4xx/5xx)

## Changes

> 21 revisions in range; 18 could not be searched.

- **2025-12-06** `30e239e76ba1` — 9 breaking, 1 warning
  - removed the request body
  - the `query` request parameter `jobid` became required
  - the response property `input` became nullable for the status `4XX`
  - the response property `input` became nullable for the status `5XX`
  - …6 more

[Change history](https://skmtc.dev/rclone/apis/rclone-rc-api/changes/job/status/post.md)

---

[API](https://skmtc.dev/rclone/apis/rclone-rc-api.md) · [All operations](https://skmtc.dev/rclone/apis/rclone-rc-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rclone/rclone-rc-api/revisions/adc0c129da4f/schema)