Documentation

Company Monitoring

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

Get Started — FreeAPI Reference

How It Works

Monitoring lets you track companies for important changes. Set it up in seconds, and the platform checks for new data every day.

01

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.

02

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.

03

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.

04

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 or more points (up or down). Covers all five risk dimensions: Financial Health, Compliance, Governance, Network Risk, and Operations.WARNING or CRITICAL
Critical SignalA severe negative signal detected — sanctions listing, winding-up petition, liquidation, administration, or disqualified director appointment. Signal score ≤ -60.CRITICAL
Status ChangeCompany status changed at Companies House — for example from Active to Dissolved, Liquidation, Administration, or Strike-off.WARNING or CRITICAL
Director ChangeNew director appointment, resignation, or secretary change recorded at Companies House.INFO
New SignalAny new data signal from any of our 53 data sources — gazette notices, regulatory changes, financial filings, trade data, and more.INFO or WARNING
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

Control how often you receive alerts. Choose per company based on how closely you need to track it.

FrequencyDescriptionBest For
InstantIndividual email for each alert, sent during the daily processing run each morning (after our data sync completes).Active investigations, high-risk counterparties
Daily DigestAll alerts for the day combined into a single email, grouped by company. Sent once daily.Ongoing monitoring, compliance portfolios
Weekly DigestAll alerts for the week combined into one email. Sent every Monday morning.Passive tracking, large watchlists

Plan Limits

The number of companies you can monitor depends on your subscription plan.

Free
3
monitored companies
Pro
25
monitored companies
Business
100
monitored companies
Scale
500
monitored companies
Enterprise
∞
unlimited monitors

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 request includes an X-Borsch-Signature header containing an HMAC-SHA256 signature of the request body. Use this to verify that the request came from borsch.ai. 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)

API Endpoints

All monitoring endpoints require JWT authentication. See the full API Reference for details.

MethodEndpointDescription
POST/alerts/quick-monitorEnable monitoring for a company (auto-creates watchlist)
GET/alerts/List alerts (paginated, filterable)
GET/alerts/unread-countUnread alert count
GET/alerts/statsMonitor usage and plan limits
PATCH/alerts/{id}/readMark alert as read
POST/alerts/mark-all-readMark all alerts as read
POST/alerts/test-webhookTest webhook delivery
GET/projects/{id}/companies/{cn}/monitoringGet monitoring settings
PUT/projects/{id}/companies/{cn}/monitoringUpdate monitoring settings

FAQ

How quickly will I be notified?
Our data sources update daily. The monitoring system processes all changes each morning. With “Instant” frequency, you'll receive an email within minutes of processing. Digests are sent once per day or week.
What data sources are checked?
All 53 of our official data sources are checked, including Companies House filings, FCA register, gazette notices, sanctions lists, land registry, and more. Any new signal from any source can trigger an alert.
Can I monitor dissolved companies?
Yes. Dissolved companies can still receive new signals — for example, gazette notices about restoration, or retrospective regulatory actions. You'll be notified if anything changes.
How do I stop monitoring a company?
Click the bell icon on the company page to open monitoring settings, then disable alerts. Alternatively, remove the company from your project watchlist. 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 URL for push-based delivery.

Start monitoring companies today

Create a free account and set up alerts for up to 3 companies. Upgrade anytime for higher limits.

Get Started — FreeView Pricing