Docs/Monitoring & Alerts

Monitoring & Alerts

Subscribe to any UK company and get notified when something important changes — risk score shifts, new sanctions, director resignations, or company status changes.

How It Works

1
Find a company
Search for any UK company using the Explorer, or visit a company page directly. You can monitor any of the 5.9 million companies in our database.
2
Enable monitoring
Click the bell icon in the company header. Choose which alert types matter to you and how often you want to be notified. The company is automatically added to your Watchlist.
3
Get notified
When our daily data sync detects a change matching your alert types, you receive an email notification or webhook callback. Digests group multiple alerts into a single message.
4
Review & act
View all alerts on your Account page. Click through to the company report for full details. Mark alerts as read once you've reviewed them.

Alert Types

Choose which types of changes matter to you. Each company can have its own combination of alert types.

Alert TypeWhat It DetectsSeverity
Risk Score ChangeRisk score moved by 10+ points across any of the five dimensionsWARNING
Critical SignalSanctions listing, winding-up petition, liquidation, administration, or disqualified directorCRITICAL
Status ChangeCompany status changed (Active to Dissolved, Liquidation, Strike-off, etc.)WARNING
Director ChangeNew appointment, resignation, or secretary change at Companies HouseINFO
New SignalAny new data signal from any of the 48 data sourcesINFO
Default Configuration
When you enable monitoring, three alert types are selected by default: Risk Score Change, Critical Signal, and Status Change. You can customise this at any time.

Notification Frequency

FrequencyDescriptionBest For
InstantIndividual email for each alert, sent during the daily processing runActive investigations, high-risk counterparties
Daily DigestAll alerts combined into a single email, grouped by companyOngoing monitoring, compliance portfolios
Weekly DigestAll alerts for the week in one email, sent every MondayPassive tracking, large watchlists

Plan Limits

PlanMonitored Companies
Free3
Pro25
Business100
Scale500
EnterpriseUnlimited

Webhooks

For programmatic integrations, configure a webhook URL to receive alert payloads as HTTP POST requests. All webhooks are signed for security.

Security
Every webhook includes an X-Uvagatron-Signature header with an HMAC-SHA256 signature. Verify this to confirm the request came from uvagatron.com. Only HTTPS URLs are accepted.
Webhook Payload
{
  "event": "company_alert",
  "alert_id": "a1b2c3d4-...",
  "company_number": "12345678",
  "company_name": "Acme Ltd",
  "alert_type": "risk_change",
  "severity": "warning",
  "alert_data": {
    "old_score": 72.3,
    "new_score": 58.1,
    "delta": -14.2,
    "old_classification": "Stable",
    "new_classification": "Watch"
  },
  "created_at": "2026-04-17T07:15:42Z"
}
Signature Verification (Python)
import hmac, hashlib

def verify_signature(body: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(
        secret.encode(), body, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", signature)

FAQ

How quickly will I be notified?
Data sources update daily. The monitoring system processes all changes each morning. With “Instant” frequency, you receive an email within minutes of processing. Digests are sent once per day or week.
Can I monitor dissolved companies?
Yes. Dissolved companies can still receive new signals — gazette notices about restoration, retrospective regulatory actions, etc. You'll be notified if anything changes.
How do I stop monitoring?
Click the bell icon on the company page to open settings, then disable alerts. You can also manage all monitors from your Account page.
Can I use monitoring via the API?
Yes. Use POST /alerts/quick-monitor to subscribe programmatically, and GET /alerts/ to poll for new alerts. Configure a webhook for push-based delivery.