---
updatedAt: 2026-10-05T22:22:50.000Z
agentTools:
  siteIndex: https://help.socure.com/llms.txt
  projectIndex: https://help.socure.com/riskos/llms.txt
---

# Enable Watchlist Monitoring for an Evaluation

Enable or disable daily watchlist monitoring for an existing evaluation. Monitored entities are checked automatically for list additions, modifications, or removals.


<Callout icon="📘" theme="info">
  **Note**:

  This endpoint is currently **unavailable in the Sandbox environment**.  Use the **Production** environment for testing and integration.
</Callout>

<br />

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Socure RiskOS™ API",
    "version": "2025-01-01.orion",
    "license": {
      "name": "Proprietary",
      "url": "https://socure.com"
    },
    "description": "*RiskOS™ documentation site is Socure confidential and proprietary information, and is only intended for viewing by authorized persons.*\n\nThe Socure RiskOS™ APIs provide a unified API framework for risk evaluation. They use predictable, resource-oriented URLs, accept JSON-formatted request bodies, return JSON-formatted responses, and follow standard HTTP methods, status codes, and authentication practices.\n\nYou can test RiskOS™ APIs in the **Sandbox environment**, which allows you to simulate requests without impacting live data. The request endpoint determines whether the request is directed to the Sandbox or Production (live) environment.\n",
    "contact": {
      "name": "Socure Support",
      "url": "https://help.socure.com",
      "email": "support@socure.com"
    }
  },
  "servers": [
    {
      "url": "https://riskos.socure.com",
      "description": "Production",
      "x-environment": "production"
    },
    {
      "url": "https://riskos.sandbox.socure.com",
      "description": "Sandbox (for testing; nothing is saved)",
      "x-environment": "sandbox"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Evaluation",
      "description": "The Evaluation API is the primary endpoint for performing Risk Evaluations in RiskOS™. \nRequests must include data that conforms to the schema defined for the specific Solution.\nSuccessful evaluation responses include a `decision` value from the following list: * `ACCEPT`: The evaluation is approved; proceed with fulfillment/onboarding and the happy‑path experience.<br /> * `REVIEW`: Additional assessment is required; route to manual review and/or configured step‑up checks per workflow logic.<br /> * `REJECT`: The evaluation has failed the required checks and the entity is rejected.\n> **Note:** **`ACCEPT`**, **`REVIEW`**, and **`REJECT`** are the default decision values. Customers can customize the response to added or to delete default values based on specific workflow needs."
    }
  ],
  "paths": {
    "/api/evaluation/monitoring": {
      "post": {
        "x-environment": [
          "production"
        ],
        "tags": [
          "Evaluation"
        ],
        "summary": "Enroll an Evaluation in Watchlist Monitoring",
        "operationId": "watchlistMonitoring",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/XApiVersionHeader"
          }
        ],
        "description": "Enable or disable daily watchlist monitoring for an existing evaluation. Monitored entities are checked automatically for additions, modifications, or removals across specified lists.\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "reference_id",
                  "list_type",
                  "operation"
                ],
                "properties": {
                  "reference_id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Unique identifier assigned to a Watchlist enrichment after a RiskOS™ workflow is finalized. You can retrieve this value from the response of a successful call to the Evaluation endpoint.\n",
                    "example": "ae94dd2e-46fe-4e58-bf0b-45ef1d4588a2"
                  },
                  "list_type": {
                    "type": "string",
                    "enum": [
                      "watchlist"
                    ],
                    "description": "Specifies the type of monitoring list to which the entity (identified by its enrichment `referenceId`) will be subscribed.\nPassing `watchlist` enables monitoring for changes across all watchlist types defined in your Monitoring policy.\n",
                    "example": "watchlist"
                  },
                  "operation": {
                    "type": "string",
                    "enum": [
                      "enable",
                      "disable"
                    ],
                    "description": "Specifies the action to be taken for monitoring enrollment.\n- `enable`: Activates Watchlist Monitoring for the specified evaluation.\n- `disable`: Deactivates Watchlist Monitoring for the specified evaluation.         \n",
                    "example": "enable"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The request was processed successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "monitoring_status"
                  ],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "description": "Indicates whether the monitoring enrollment operation was successful.",
                      "example": true
                    },
                    "monitoring_status": {
                      "type": "string",
                      "enum": [
                        "enabled",
                        "disabled"
                      ],
                      "description": "Current status of the monitoring subscription after the operation has been processed.\n",
                      "example": "enabled"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - The request was unacceptable."
          },
          "401": {
            "description": "Unauthorized - An invalid API key was provided."
          },
          "403": {
            "description": "Forbidden - The client does not have permission to access this resource."
          },
          "404": {
            "description": "Not Found - The requested resource does not exist."
          },
          "500": {
            "description": "Internal Server Error – Unexpected server issue."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Socure provides separate RiskOS™ keys for the Sandbox and Production environments. Be sure to use the correct key when making a request.\n"
      }
    },
    "parameters": {
      "XApiVersionHeader": {
        "name": "X-API-Version",
        "in": "header",
        "description": "This header is optional. If omitted, requests use the current default version, `2025-01-01.orion`. Set this header to pin your integration to a specific API version.",
        "required": false,
        "schema": {
          "type": "string",
          "example": "2025-01-01.orion"
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": false,
    "samples-languages": [
      "shell",
      "java",
      "python",
      "node",
      "go"
    ],
    "parameter-ordering": [
      "path",
      "query",
      "header",
      "body",
      "cookie",
      "form"
    ],
    "x-tagGroups": [
      {
        "name": "Core Risk Evaluation",
        "tags": [
          "Evaluation",
          "Feedback",
          "Outcome"
        ]
      },
      {
        "name": "Watchlist",
        "tags": [
          "Custom Watchlist"
        ]
      },
      {
        "name": "Reference Data",
        "tags": [
          "Reason Codes"
        ]
      }
    ]
  }
}
```

# Sibling pages

* [Manage a Custom Watchlist Record](https://help.socure.com/riskos/reference/custom-watchlist.md)