---
title: "Get run by id"
method: GET
path: "/runs/{id}"
tags: ["Runs"]
---

# Get run by id

`GET /runs/{id}`

## Request

- Base URL: `https://localhost:8446/api/v2`
- URL: `https://localhost:8446/api/v2/runs/{id}`
- Auth: API key in header `Authorization`

Returns job info.

## Path parameters

- `id` number, required

## Response `200`

Successful response

- object
  - `id` number, required: Job run id
  - `job_id` number, required: Job id
  - `type` string, required: Job type
  - `run_type` string, required: Run type
  - `name` string, required: Job name
  - `active` boolean, required: Specify if currently running
  - `run_id` number, required: Sequential number of job run
  - `status` string, required: Job status. Possible values: working - Job run is working finished - Job run is finished successfully aborted - Job run was aborted timeout - Job run was aborted by timeout paused - Job run is paused
  - `files_total` number: Total number of files
  - `size_total` number: Total files size in bytes
  - `files_completed` number: Number of completed files
  - `size_completed` number: Size of completed files in bytes
  - `transferred` number: Bytes transferred
  - `agents_completed` number, required: Number of completed Agents
  - `agents_total` number, required: Number of all job Agents
  - `agents_inprogress` number, required: Number of Agents in progress
  - `agents_offline` number, required: Number of offline Agents
  - `agents_failed` number, required: Number of failed Agents
  - `start_time` number: Job run start time (timestamp in seconds). For sync, file_caching and hybrid_work jobs it's the time when status working was set last time.
  - `finish_time` number: Job run finish time (timestamp in seconds). Not available for sync, file_caching and hybrid_work job
  - `duration` number: Job run duration (in seconds). For active sync, file_caching and hybrid_work jobs (status is not finished) it's difference between current time and start_time, otherwise it has 0 value.
  - `last_synced` number: sync, file_caching and hybrid_work job last synced time (in seconds)
  - `down_speed` number: Total download speed
  - `up_speed` number: Total upload speed
  - `max_speed` number: Maximum job run speed
  - `transfer_eta` number: Job run transfer eta in seconds. Not available for script job
  - `progress` number: Job run transfer progress. Not available for script job
  - `started_by` string: User who started job run. Empty in case job run was started by scheduler
  - `errors` object, required: List of errors
  - `errors.code` number: Error code (deprecated since 2.9.1)
  - `errors.code_str` string, required: Error string code
  - `errors.message` string, required: Error message
  - `errors.agent_id` number: Agent id
  - `errors.folderid` number: Transfer id
  - `event_logs_complete` boolean: A property indicates that all event have been delivered. Applicable only to finished job runs except for sync, file_caching and hybrid_work job

## Other responses

- `default`: Error response. Depending on the error, either a 4xx or 5xx response status is returned.

---

[API](https://skmtc.dev/resilio/apis/resilio-api.md) - [All operations](https://skmtc.dev/resilio/apis/resilio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/resilio/apis/resilio-api/revisions/ca39130a395e?raw)