---
title: Scanning tasks
description: The task scanner 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: pingoneaic
page_id: pingoneaic:idm-rest-api:endpoints/rest-task-scanner
canonical_url: https://docs.pingidentity.com/pingoneaic/idm-rest-api/endpoints/rest-task-scanner.html
---

# Scanning tasks

The [task scanner](../../idm-schedules/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.

The following table lists the endpoints associated with the task scanner:

| URI                                              | HTTP Operation | Description                                  |
| ------------------------------------------------ | -------------- | -------------------------------------------- |
| /openidm/taskscanner                             | GET            | Returns all present and past scanning tasks. |
| /openidm/taskscanner/id                          | GET            | Returns a task by `id`.                      |
| /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.         |