For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact SalesGet Support
HomeGuidesAPI reference
HomeGuidesAPI reference
  • Middesk API
        • GETList liens for a business
        • POSTCreate a lien for a business
        • POSTCreate lien filings in batch
LogoLogo
Contact SalesGet Support
Middesk APIBusiness VerificationLiens

Create a lien for a business

POST
https://api.middesk.com/v1/businesses/:business_id/liens
POST
/v1/businesses/:business_id/liens
$curl -X POST https://api.middesk.com/v1/businesses/business_id/liens \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "debtors": [
>    {
>      "organization_name": "Acme Corporation",
>      "addresses": [
>        {
>          "address_line1": "123 Main Street",
>          "city": "San Francisco",
>          "state": "CA",
>          "postal_code": "94105"
>        }
>      ]
>    }
>  ],
>  "state": "CA",
>  "secured_parties": [
>    {
>      "organization_name": "First National Bank",
>      "role": "assignee",
>      "addresses": [
>        {
>          "address_line1": "456 Finance Avenue",
>          "city": "Los Angeles",
>          "state": "CA",
>          "postal_code": "90210"
>        }
>      ]
>    }
>  ],
>  "collateral": "All business assets and inventory",
>  "loan_principal_amount_cents": 50000000
>}'
1{
2  "object": "lien",
3  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
4  "type": "ucc",
5  "business_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
6  "debtors": [
7    {
8      "name": "Acme Corporation",
9      "addresses": [
10        {
11          "full_address": "123 Main Street, San Francisco, CA 94105",
12          "address_line1": "123 Main Street",
13          "city": "San Francisco",
14          "state": "CA",
15          "postal_code": "94105"
16        }
17      ]
18    }
19  ],
20  "secured_parties": [
21    {
22      "name": "First National Bank",
23      "addresses": [
24        {
25          "full_address": "456 Finance Avenue, Los Angeles, CA 90210",
26          "address_line1": "456 Finance Avenue",
27          "city": "Los Angeles",
28          "state": "CA",
29          "postal_code": "90210"
30        }
31      ]
32    }
33  ],
34  "state": "CA",
35  "status": "created",
36  "collateral": "All business assets and inventory",
37  "negative_pledge": false,
38  "loan_principal_amount_cents": 50000000,
39  "packet_number": "PKT-12345",
40  "status_category": "pending",
41  "owner_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
42  "owner_type": "Business"
43}
Was this page helpful?
Previous

Create lien filings in batch

Next
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

business_idstringRequired
Business ID

Request

This endpoint expects an object.
debtorslist of objectsRequired
Array of debtor details
stateenumOptional

State where the lien will be filed. Use state for a single state or states for multiple states. If both are provided, states takes precedence.

stateslist of enumsOptional

Array of states to file the lien in. Creates one lien per state. Returns a list response. Either state or states is required.

secured_partieslist of objectsOptional

Array of secured party details (optional - uses account defaults if not provided)

secured_partyobjectOptional

Single secured party (alternative to secured_parties array)

collateralstringOptional

Collateral description (optional - uses account default if not provided)

loan_principal_amount_centsintegerOptional
Loan principal amount in cents
packet_numberstringOptional

Packet number for the filing (optional - auto-generated if not provided)

alternative_designationstringOptional

Alternative designation (for Tennessee filings)

Response

lien created using account defaults

Errors

400
Create Lien Request Bad Request Error
403
Create Lien Request Forbidden Error
404
Create Lien Request Not Found Error