> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.middesk.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.middesk.com/_mcp/server. # Lien object > Lists the contents of a lien object. This page describes the `lien` object, which represents a security interest filed against a business. Liens include UCC filings, tax liens, judgment liens, and other types of encumbrances that may affect a business's assets or creditworthiness. **`Example JSON response`** ```json title="Example JSON response" { "object": "lien", "type": "ucc", "id": "f074244d-5cf3-4703-950a-73a7d54ee555", "business_id": "b3638510-87ec-425e-bdaa-ad6e48dec871", "debtors": [ { "name": "Acme Corporation", "type": "ORGANIZATION", "addresses": [ { "full_address": "2180 Bryant St, San Francisco, CA 94110", "address_line1": "2180 Bryant St", "address_line2": null, "city": "San Francisco", "state": "CA", "postal_code": "94110" } ] } ], "secured_parties": [ { "name": "First National Bank", "type": "ORGANIZATION", "addresses": [ { "full_address": "100 Main St, New York, NY 10001", "address_line1": "100 Main St", "address_line2": null, "city": "New York", "state": "NY", "postal_code": "10001" } ] } ], "file_number": "202312345678", "state": "CA", "status": "open", "status_category": "active", "filing_date": "2023-06-15", "updated_date": "2023-06-15", "lapse_date": "2028-06-15", "collateral": "All inventory, equipment, and accounts receivable", "collateral_type": "All Assets and Receivables", "negative_pledge": false, "loan_principal_amount_cents": 50000000, "source": "https://bizfileonline.sos.ca.gov/search/business", "owner_id": "b3638510-87ec-425e-bdaa-ad6e48dec871", "owner_type": "Business", "documents": [] } ``` ## Lien attributes | Attribute | Type | Description | | ------------------------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `object` | string | The object type. Always `lien`. | | `type` | string | The type of lien. Possible values: `ucc`, `state`, `federal`, `attachment`, `judgment`. | | `id` | string (uuid) | The unique identifier for the lien. | | `business_id` | string (uuid) | The unique identifier of the associated business. | | `debtors` | object\[] | An array of debtor information. | | `debtors[].name` | string | The name of the debtor. | | `debtors[].type` | string | The type of debtor. Possible values: `ORGANIZATION`, `INDIVIDUAL`, `UNKNOWN`, `Business`. | | `debtors[].party_type` | string | The party type designation. | | `debtors[].organization_name` | string | The organization name of the debtor. | | `debtors[].entity_type` | string | The entity type of the debtor. | | `debtors[].first_name` | string | The first name of an individual debtor. | | `debtors[].last_name` | string | The last name of an individual debtor. | | `debtors[].addresses` | object\[] | Addresses associated with the debtor. | | `secured_parties` | object\[] | An array of secured party information. | | `secured_parties[].name` | string | The name of the secured party (creditor). | | `secured_parties[].type` | string | The type of secured party. Possible values: `ORGANIZATION`, `INDIVIDUAL`. | | `secured_parties[].role` | string | The role of the secured party. | | `secured_parties[].organization_name` | string | The organization name of the secured party. | | `secured_parties[].addresses` | object\[] | Addresses associated with the secured party. | | `file_number` | string \| null | The official filing number for the lien. | | `state` | string | The two-letter state code where the lien was filed. | | `status` | string | The current status of the lien. Possible values: `created`, `pending`, `open`, `closing`, `closed`, `unknown`, `filed`, `failed`. | | `status_category` | string | The categorized status. Possible values: `active`, `open`, `closed`, `terminated`, `processing`, `unknown`, `failed`. | | `filing_date` | date \| null | The date the lien was originally filed. | | `updated_date` | date \| null | The date the lien was last updated. | | `lapse_date` | date \| null | The date the lien expires if not continued. | | `collateral` | string \| null | A description of the collateral securing the lien. | | `collateral_type` | string \| null | The type of collateral. Possible values: `Blanket`, `Collateral`, `Unknown`, `All Assets and Receivables`, `All Receivables`, `All Assets`, `Named Assets`, `Unavailable`. | | `negative_pledge` | boolean | Whether this is a negative pledge (prevents debtor from granting other security interests). | | `confirmation_number` | string \| null | A confirmation number if available. | | `loan_principal_amount_cents` | integer \| null | The principal loan amount in cents. | | `liability_cents` | integer \| null | The liability amount in cents. | | `source` | string (uri) \| null | A URL to the source of the lien data. | | `packet_number` | string \| null | The packet number if applicable. | | `lien_termination` | object \| null | Termination details if the lien has been terminated. | | `alternative_designation` | string \| null | Alternative party designation. Possible values: `buyer_seller`, `bailee_bailor`, `consignee_consignor`, `lessee_lessor`, `licensee_licensor`. | | `owner_id` | string (uuid) | The polymorphic owner ID (typically the business ID). | | `owner_type` | string | The polymorphic owner type (typically `Business`). | | `filed_by_account` | boolean \| null | Whether the lien was filed by the account. | | `documents` | Document\[] | An array of associated lien documents. | ## Lien types | Type | Description | | ------------ | ------------------------------------------------------------------------------------------------------------------------ | | `ucc` | Uniform Commercial Code filing - a financing statement filed to give notice of a security interest in personal property. | | `state` | A state tax lien filed for unpaid state taxes. | | `federal` | A federal tax lien filed by the IRS for unpaid federal taxes. | | `attachment` | A court-ordered lien that attaches to property during litigation. | | `judgment` | A lien resulting from a court judgment. | ## Lien status categories | Status Category | Description | | --------------- | ---------------------------------------------------------------- | | `active` | The lien is currently active and enforceable. | | `open` | The lien is open. | | `closed` | The lien has been satisfied or otherwise closed. | | `terminated` | The lien has been formally terminated by the secured party. | | `processing` | The lien is currently being processed. | | `unknown` | The lien status could not be determined. | | `failed` | The lien filing is rejected by the state and is not resubmitted. | ## Collateral types | Collateral Type | Description | | ---------------------------- | -------------------------------------------------------- | | `Blanket` | A blanket lien covering all assets of the debtor. | | `All Assets and Receivables` | Lien covers all business assets and accounts receivable. | | `All Receivables` | Lien covers only accounts receivable. | | `All Assets` | Lien covers all business assets. | | `Named Assets` | Lien covers specifically named assets only. | | `Collateral` | General collateral designation. | | `Unknown` | Collateral type could not be determined. | | `Unavailable` | Collateral information is not available. | > **Get a demo** > > Contact your account manager or [contact sales](https://www.middesk.com/contact-sales) to inquire about access.