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).

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) or detects that an existing lien is terminated (lien.terminated).
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