> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vouchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List monitored vendors

> Vendors currently subscribed to Smart Sentinel.

Returns every vendor you have under Smart Sentinel monitoring, with the current risk tier, claim status, Vouchmark Score, whether there are alerts, and the most recent events.

## Query parameters

<ParamField query="riskTier" type="string">
  Filter by risk tier: `LOW`, `MEDIUM`, `HIGH`, or `CRITICAL`.
</ParamField>

<ParamField query="claimStatus" type="string">
  Filter by claim status: `claimed` or `unclaimed`.
</ParamField>

<ParamField query="hasAlerts" type="boolean">
  Filter to vendors that have alerts (`true`) or have none (`false`).
</ParamField>

<ParamField query="sortBy" type="string">
  Sort order: `score` or `lastEvent`.
</ParamField>

<ParamField query="page" type="integer" default="1" />

<ParamField query="limit" type="integer" default="20">
  Max 100.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.vouchmark.com/v1/monitoring/vendors?riskTier=HIGH&sortBy=score" \
    -H "Authorization: Bearer $TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": [
      {
        "vendorId": "cmp_aBcD...",
        "vendorName": "TEKCIFY TECHNOLOGIES LTD",
        "riskTier": "HIGH",
        "claimStatus": "claimed",
        "score": 90,
        "hasAlerts": true,
        "recentEvents": [
          {
            "eventId": "evt_aBcDeFgH...",
            "severity": "HIGH",
            "agentName": "firs-tin",
            "whatChanged": "TIN status changed from ACTIVE to INACTIVE",
            "createdAt": "2026-05-11T18:42:00Z"
          }
        ]
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "totalPages": 1
    }
  }
  ```
</ResponseExample>