Monitor liens
This guide describes how to monitor a business for UCC lien activity on Middesk’s Identity Platform.
Lien Monitoring helps you stay informed when new UCC liens are filed against a business or when an existing lien is terminated.
When a lien change is detected, Middesk updates the business record and sends a webhook event (lien.found or lien.terminated).
After the initial monitoring order, Middesk performs UCC lien checks every two weeks to identify changes.
Prerequisites
Before you begin:
- Ensure that you can authenticate against the Middesk API, create businesses, and ingest Middesk results with webhooks
Learn the monitoring lifecycle
Here’s the typical lifecycle of monitoring for liens:
- A business gets created with the POST /businesses endpoint.
- The business is subscribed to Lien Monitoring (using the
lienevent type). - Middesk performs an initial lien check and then re-checks on an ongoing cadence.
- A webhook event is sent to registered webhook endpoint(s) when a new lien is found (
lien.found) or an existing lien is terminated (lien.terminated). - The client application ingests and evaluates the change in the business record.
For a full list of webhook events, see Webhook events. For details on the lien data model, see the Lien object.
