curl "https://api.vouchmark.com/v1/monitoring/alerts?read=false" \
-H "Authorization: Bearer $TOKEN"
{
"success": true,
"data": [
{
"alertId": "al_aBcD...",
"customerId": "usr_aBcD...",
"vendorId": "cmp_aBcD...",
"vendorName": "TEKCIFY TECHNOLOGIES LTD",
"eventId": "evt_aBcDeFgH...",
"severity": "HIGH",
"title": "TIN status changed",
"message": "TIN status changed from ACTIVE to INACTIVE for TEKCIFY TECHNOLOGIES LTD.",
"whatChanged": "TIN status changed from ACTIVE to INACTIVE",
"monitoringUrl": "https://app.vouchmark.com/monitoring/vendors/cmp_aBcD...",
"read": false,
"createdAt": "2026-05-11T18:42:00Z",
"updatedAt": "2026-05-11T18:42:00Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1
}
}
Monitoring
List alerts
Alerts across every vendor you monitor.
GET
/
v1
/
monitoring
/
alerts
curl "https://api.vouchmark.com/v1/monitoring/alerts?read=false" \
-H "Authorization: Bearer $TOKEN"
{
"success": true,
"data": [
{
"alertId": "al_aBcD...",
"customerId": "usr_aBcD...",
"vendorId": "cmp_aBcD...",
"vendorName": "TEKCIFY TECHNOLOGIES LTD",
"eventId": "evt_aBcDeFgH...",
"severity": "HIGH",
"title": "TIN status changed",
"message": "TIN status changed from ACTIVE to INACTIVE for TEKCIFY TECHNOLOGIES LTD.",
"whatChanged": "TIN status changed from ACTIVE to INACTIVE",
"monitoringUrl": "https://app.vouchmark.com/monitoring/vendors/cmp_aBcD...",
"read": false,
"createdAt": "2026-05-11T18:42:00Z",
"updatedAt": "2026-05-11T18:42:00Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1
}
}
Returns the alert inbox for the authenticated user — the same feed shown in the dashboard’s monitoring sidebar. Alerts are derived from monitoring events.
Marks a single alert as read and returns the updated record.
Query parameters
boolean
Filter by read state:
true for read, false for unread. Omit to return all.string
Filter to alerts for a specific vendor.
string
Filter by severity:
LOW, MEDIUM, HIGH, or CRITICAL.integer
default:"1"
integer
default:"20"
Max 100.
curl "https://api.vouchmark.com/v1/monitoring/alerts?read=false" \
-H "Authorization: Bearer $TOKEN"
{
"success": true,
"data": [
{
"alertId": "al_aBcD...",
"customerId": "usr_aBcD...",
"vendorId": "cmp_aBcD...",
"vendorName": "TEKCIFY TECHNOLOGIES LTD",
"eventId": "evt_aBcDeFgH...",
"severity": "HIGH",
"title": "TIN status changed",
"message": "TIN status changed from ACTIVE to INACTIVE for TEKCIFY TECHNOLOGIES LTD.",
"whatChanged": "TIN status changed from ACTIVE to INACTIVE",
"monitoringUrl": "https://app.vouchmark.com/monitoring/vendors/cmp_aBcD...",
"read": false,
"createdAt": "2026-05-11T18:42:00Z",
"updatedAt": "2026-05-11T18:42:00Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1
}
}
Mark as read
string
required
curl -X PATCH https://api.vouchmark.com/v1/monitoring/alerts/al_aBcD.../read \
-H "Authorization: Bearer $TOKEN"
{
"success": true,
"data": {
"alertId": "al_aBcD...",
"read": true,
"updatedAt": "2026-05-12T09:15:00Z",
"vendorId": "cmp_aBcD...",
"eventId": "evt_aBcDeFgH..."
}
}