---
title: Scanning tasks
description: The task scanning mechanism lets you perform a batch scan for a specified date, on a scheduled interval, and then execute a task when this date is reached.
component: pingidm
version: 8.1
page_id: pingidm:rest-api-reference:endpoints/rest-task-scanner
canonical_url: https://docs.pingidentity.com/pingidm/8.1/rest-api-reference/endpoints/rest-task-scanner.html
keywords: ["REST API", "Task Scanner"]
---

# Scanning tasks

The [task scanning mechanism](../../schedules-guide/task-scanner.html) lets you perform a batch scan for a specified date, on a scheduled interval, and then execute a task when this date is reached.

IDM provides REST access to the task scanner, as listed in the following table:

| URI                                              | HTTP Operation | Description                                     |
| ------------------------------------------------ | -------------- | ----------------------------------------------- |
| /openidm/taskscanner                             | GET            | Lists all the scanning tasks, past and present. |
| /openidm/taskscanner/id                          | GET            | Lists details of the given task.                |
| /openidm/taskscanner?\_action=execute\&name=name | POST           | Triggers the specified task scan run.           |
| /openidm/taskscanner/id?\_action=cancel          | POST           | Cancels the specified task scan run.            |