---
title: Reconciliation operations
description: You can interact with the reconciliation engine over REST, as shown in the following table:
component: pingidm
version: 7.3
page_id: pingidm:rest-api-reference:endpoints/rest-recon
canonical_url: https://docs.pingidentity.com/pingidm/8.1/rest-api-reference/endpoints/rest-recon.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", "Recomciliation"]
superseded_by: https://docs.pingidentity.com/pingidm/8.1/rest-api-reference/endpoints/rest-recon.html
---

# Reconciliation operations

You can interact with the reconciliation engine over REST, as shown in the following table:

| URI                                                            | HTTP Operation | Description                                                                                                                |
| -------------------------------------------------------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------- |
| /openidm/recon                                                 | GET            | Lists all reconciliation runs, including those in progress. Inspect the `state` property to see the reconciliation status. |
| /openidm/recon?\_action=recon\&mapping=mapping-name            | POST           | Launches a reconciliation run with the specified mapping.                                                                  |
| /openidm/recon?\_action=reconById\&mapping=mapping-name\&id=id | POST           | Restricts the reconciliation run to the specified ID.                                                                      |
| /openidm/recon/id?\_action=cancel                              | POST           | Cancels the specified reconciliation run.                                                                                  |

The following example runs a reconciliation for the [mapping](../../synchronization-guide/mappings.html) `systemHrdb_managedUser`:

```
curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Accept-API-Version: resource=1.0" \
--request POST \
"http://localhost:8080/openidm/recon?_action=recon&mapping=systemHrdb_managedUser"
```