Skip to main content
GET
/
v1
/
monitoring
/
vendors
curl "https://api.vouchmark.com/v1/monitoring/vendors?riskTier=HIGH&sortBy=score" \
  -H "Authorization: Bearer $TOKEN"

{
  "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
  }
}
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

​
riskTier
string
Filter by risk tier: LOW, MEDIUM, HIGH, or CRITICAL.
​
claimStatus
string
Filter by claim status: claimed or unclaimed.
​
hasAlerts
boolean
Filter to vendors that have alerts (true) or have none (false).
​
sortBy
string
Sort order: score or lastEvent.
​
page
integer
default:"1"
​
limit
integer
default:"20"
Max 100.
curl "https://api.vouchmark.com/v1/monitoring/vendors?riskTier=HIGH&sortBy=score" \
  -H "Authorization: Bearer $TOKEN"

{
  "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
  }
}