Skip to main content

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.

Verification is a snapshot. Smart Sentinel is the camera that keeps rolling — it re-runs authoritative checks on a schedule and watches open-source feeds for material events about your vendors. When something changes, you get an alert with the evidence attached.

​
What it watches

Sentinel runs as a fleet of small, single-purpose agents. Each agent owns one source.
AgentSourceCadence
cac-statusCAC company registrydaily
firs-tinFIRS / JTB taxpayer registryweekly
sanctionsOFAC, UN, EU consolidated listdaily
gdeltGDELT global news projecthourly
cbn-rssCBN circulars & advisorieshourly
google-newsGoogle News for the company namedaily
Each agent compares the latest payload to the last one we stored. If the hash differs, it produces a structured monitoring event rather than a raw blob — already classified by severity, with the changed fields called out.

​
Event lifecycle

1

Detect

The agent runs, fetches data, and compares against the stored baseline.
2

Emit

A MonitoringEvent is written with severity, title, description, and changedFields.
3

Alert

An alert is fanned out to the customers who have this vendor under monitoring, respecting their notification preferences.
4

Resolve

The customer reads or acks the alert. If a sentinel finding warrants action, it may trigger a deeper Investigation Report.

​
Severities

SeverityExamples
HIGHCAC status flipped to INACTIVE, FIRS TIN deactivated, sanctions match, taxpayer name mismatch.
MEDIUMDirector added or removed, share-capital change, adverse news with strong topical match.
LOWAddress change, contact change, low-confidence news mention.
High-severity events can revoke a Trust Badge automatically; medium and low events are surfaced but never auto-revoke.

​
Subscribing a vendor

You opt a verified company into monitoring from the dashboard or the API: 
curl -X POST https://api.vouchmark.com/v1/monitoring/vendors \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"companyId":"cmp_aBcD..."}'
Once subscribed, the company appears in GET /v1/monitoring/vendors and an event stream becomes available at GET /v1/monitoring/vendors/:vendorId/events.

​
Tuning the noise

Smart Sentinel is opinionated — it prefers signal over recall. Every agent has:
  • A payload digest so unchanged data doesn’t fire alerts.
  • A circuit breaker that opens after repeated upstream failures (so an outage at FIRS doesn’t drown the user in fake “TIN unavailable” events).
  • A rate limiter with jitter so we don’t hammer source systems.
You can mute individual agents per vendor from the dashboard if a particular feed is generating noise for that name.

​
Where to go next

Verification lifecycle

Where Sentinel sits in the overall flow.

Webhooks

Receive monitoring events at your own endpoint.