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 and when an existing lien is terminated, continued, or lapses. When a lien change is detected, Middesk updates the business record and sends a webhook event (lien.found, lien.terminated, lien.continued, or lien.lapsed).

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:

1. A business gets created with the POST /businesses endpoint.

2. The business is subscribed to Lien Monitoring (using the lien event type).
3. Middesk performs an initial lien check and then re-checks on an ongoing cadence.
4. Middesk sends a webhook event to registered webhook endpoint(s) when it finds a new lien (lien.found), detects that an existing lien is terminated (lien.terminated), detects that a continuation filing extended a lien’s lapse date (lien.continued), or detects that an open lien passed its lapse date without a continuation (lien.lapsed).
5. 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.

Monitor liens