---
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: 7.3
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
llms_txt: https://docs.pingidentity.com/pingidm/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
keywords: ["REST API", "Task Scanner"]
superseded_by: https://docs.pingidentity.com/pingidm/8.1/rest-api-reference/endpoints/rest-task-scanner.html
---

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