Lien object | Middesk

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

1 {
2   "object": "lien",
3   "type": "ucc",
4   "id": "f074244d-5cf3-4703-950a-73a7d54ee555",
5   "business_id": "b3638510-87ec-425e-bdaa-ad6e48dec871",
6   "debtors": [
7     {
8       "name": "Acme Corporation",
9       "type": "ORGANIZATION",
10       "addresses": [
11         {
12           "full_address": "2180 Bryant St, San Francisco, CA 94110",
13           "address_line1": "2180 Bryant St",
14           "address_line2": null,
15           "city": "San Francisco",
16           "state": "CA",
17           "postal_code": "94110"
18         }
19       ]
20     }
21   ],
22   "secured_parties": [
23     {
24       "name": "First National Bank",
25       "type": "ORGANIZATION",
26       "addresses": [
27         {
28           "full_address": "100 Main St, New York, NY 10001",
29           "address_line1": "100 Main St",
30           "address_line2": null,
31           "city": "New York",
32           "state": "NY",
33           "postal_code": "10001"
34         }
35       ]
36     }
37   ],
38   "file_number": "202312345678",
39   "state": "CA",
40   "status": "open",
41   "status_category": "active",
42   "filing_date": "2023-06-15",
43   "updated_date": "2023-06-15",
44   "lapse_date": "2028-06-15",
45   "collateral": "All inventory, equipment, and accounts receivable",
46   "collateral_type": "All Assets and Receivables",
47   "negative_pledge": false,
48   "loan_principal_amount_cents": 50000000,
49   "source": "https://bizfileonline.sos.ca.gov/search/business",
50   "owner_id": "b3638510-87ec-425e-bdaa-ad6e48dec871",
51   "owner_type": "Business",
52   "documents": []
53 }

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`.
`status_category`	string	The categorized status. Possible values: `active`, `open`, `closed`, `terminated`, `processing`, `unknown`.
`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 will expire 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.

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 to inquire about access.