---
title: "Get folder rescan details"
method: GET
path: "/runs/{id}/agents/{agent_id}/scans"
tags: ["Runs"]
---

# Get folder rescan details

`GET /runs/{id}/agents/{agent_id}/scans`

## Request

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

Returns folder rescan details.

## Path parameters

- `id` string, required
- `agent_id` string, required

## Response `200`

Successful response

- object
  - `start_time` number, required: Start time (in seconds)
  - `status` string, required: Status. Possible values: Scheduled Running Completed Aborted Suspended
  - `type` string, required: Type. Possible values: full rescan rescan subfolder
  - `duration` number, required: Duration (in seconds)
  - `files` number, required: Files
  - `folders` number, required: Folders
  - `size` number, required: Size
  - `reason` string, required: Rescan trigger. Reported by Agents of version 3.4.0 and newer. Default value is empty string.
  - `abort_reason` string, required: Abort reason. Reported by Agents of version 3.4.0 and newer. Default value is empty string.
  - `failed_folders` number, required: Failed folders. Reported by Agents of version 3.4.0 and newer. Default value is 0

## 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)
