> 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. # Create a lien for a business POST https://api.middesk.com/v1/businesses/{business_id}/liens Content-Type: application/json Reference: https://docs.middesk.com/api-reference/business-verification/liens/create-lien ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Request ### Path parameters - `business_id` (string, required) — Business ID ### Body (application/json) This endpoint expects an object. - `debtors` (list of LienRequestParamDebtorsItem, required) — Array of debtor details - `state` (enum, optional) — 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. - Allowed values: `AL`, `AK`, `AZ`, `AR`, `CA`, `CO`, `CT`, `DE`, `FL`, `GA`, `HI`, `ID`, `IL`, `IN`, `IA`, `KS`, `KY`, `LA`, `ME`, `MD`, `MA`, `MI`, `MN`, `MS`, `MO`, `MT`, `NE`, `NV`, `NH`, `NJ`, `NM`, `NY`, `NC`, `ND`, `OH`, `OK`, `OR`, `PA`, `RI`, `SC`, `SD`, `TN`, `TX`, `UT`, `VT`, `VA`, `WA`, `WV`, `WI`, `WY` - `states` (list of enum, optional) — Array of states to file the lien in. Creates one lien per state. Returns a list response. Either `state` or `states` is required. - Allowed values: `AL`, `AK`, `AZ`, `AR`, `CA`, `CO`, `CT`, `DE`, `FL`, `GA`, `HI`, `ID`, `IL`, `IN`, `IA`, `KS`, `KY`, `LA`, `ME`, `MD`, `MA`, `MI`, `MN`, `MS`, `MO`, `MT`, `NE`, `NV`, `NH`, `NJ`, `NM`, `NY`, `NC`, `ND`, `OH`, `OK`, `OR`, `PA`, `RI`, `SC`, `SD`, `TN`, `TX`, `UT`, `VT`, `VA`, `WA`, `WV`, `WI`, `WY` - `secured_parties` (list of LienRequestParamSecuredPartiesItem, optional) — Array of secured party details (optional - uses account defaults if not provided) - `secured_party` (LienRequestParamSecuredParty, optional) — Single secured party (alternative to secured_parties array) - `collateral` (string, optional) — Collateral description (optional - uses account default if not provided) - `loan_principal_amount_cents` (integer, optional) — Loan principal amount in cents - `packet_number` (string, optional) — Packet number for the filing (optional - auto-generated if not provided). Cannot contain underscores. - `alternative_designation` (string, optional) — Alternative designation (for Tennessee filings) ## Response ### 201 lien created using account defaults - `any` ## Errors ### 400 Create Lien Request Bad Request Error invalid secured parties configuration - `errors` (list of ErrorResponseErrorsItem, required) ### 403 Create Lien Request Forbidden Error identity or verify order required - `errors` (list of ErrorResponseErrorsItem, required) ### 404 Create Lien Request Not Found Error business not found - `errors` (list of ErrorResponseErrorsItem, required) ## Types ### LienRequestParamDebtorsItem - `organization_name` (string, optional) — Debtor organization name - `tin` (string, optional) — Tax identification number (required for certain states) - `addresses` (list of LienAddress, optional) ### LienRequestParamSecuredPartiesItem - `organization_name` (string, optional) — Secured party organization name - `role` (enum, optional) — Role (assignee or assignor) - Allowed values: `assignee`, `assignor` - `addresses` (list of LienAddress, optional) ### LienRequestParamSecuredParty Single secured party (alternative to secured_parties array) - `organization_name` (string, optional) — Secured party organization name - `role` (enum, optional) — Role (assignee or assignor) - Allowed values: `assignee`, `assignor` - `addresses` (list of LienAddress, optional) ### ErrorResponseErrorsItem - `message` (string, required) - `parameter` (string, optional) — Request parameter associated with the error, when applicable ### LienAddress - `address_line1` (string, optional) - `address_line2` (string, optional) - `city` (string, optional) - `state` (enum, optional) - Allowed values: `AL`, `AK`, `AZ`, `AR`, `CA`, `CO`, `CT`, `DE`, `FL`, `GA`, `HI`, `ID`, `IL`, `IN`, `IA`, `KS`, `KY`, `LA`, `ME`, `MD`, `MA`, `MI`, `MN`, `MS`, `MO`, `MT`, `NE`, `NV`, `NH`, `NJ`, `NM`, `NY`, `NC`, `ND`, `OH`, `OK`, `OR`, `PA`, `RI`, `SC`, `SD`, `TN`, `TX`, `UT`, `VT`, `VA`, `WA`, `WV`, `WI`, `WY` - `postal_code` (string, optional) ## Examples **Request** ```json { "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 } ``` **Response** ```json { "business_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "collateral": "All business assets and inventory", "debtors": [ { "addresses": [ { "address_line1": "123 Main Street", "city": "San Francisco", "full_address": "123 Main Street, San Francisco, CA 94105", "postal_code": "94105", "state": "CA" } ], "name": "Acme Corporation" } ], "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "loan_principal_amount_cents": 50000000, "negative_pledge": false, "object": "lien", "owner_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "owner_type": "Business", "packet_number": "PKT-12345", "secured_parties": [ { "addresses": [ { "address_line1": "456 Finance Avenue", "city": "Los Angeles", "full_address": "456 Finance Avenue, Los Angeles, CA 90210", "postal_code": "90210", "state": "CA" } ], "name": "First National Bank" } ], "state": "CA", "status": "created", "status_category": "pending", "type": "ucc" } ``` **SDK Code** ```python Lien filing request import requests url = "https://api.middesk.com/v1/businesses/business_id/liens" payload = { "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 } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Lien filing request const url = 'https://api.middesk.com/v1/businesses/business_id/liens'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"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}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Lien filing request package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses/business_id/liens" payload := strings.NewReader("{\n \"debtors\": [\n {\n \"organization_name\": \"Acme Corporation\",\n \"addresses\": [\n {\n \"address_line1\": \"123 Main Street\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"postal_code\": \"94105\"\n }\n ]\n }\n ],\n \"state\": \"CA\",\n \"secured_parties\": [\n {\n \"organization_name\": \"First National Bank\",\n \"role\": \"assignee\",\n \"addresses\": [\n {\n \"address_line1\": \"456 Finance Avenue\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"postal_code\": \"90210\"\n }\n ]\n }\n ],\n \"collateral\": \"All business assets and inventory\",\n \"loan_principal_amount_cents\": 50000000\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Lien filing request require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses/business_id/liens") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"debtors\": [\n {\n \"organization_name\": \"Acme Corporation\",\n \"addresses\": [\n {\n \"address_line1\": \"123 Main Street\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"postal_code\": \"94105\"\n }\n ]\n }\n ],\n \"state\": \"CA\",\n \"secured_parties\": [\n {\n \"organization_name\": \"First National Bank\",\n \"role\": \"assignee\",\n \"addresses\": [\n {\n \"address_line1\": \"456 Finance Avenue\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"postal_code\": \"90210\"\n }\n ]\n }\n ],\n \"collateral\": \"All business assets and inventory\",\n \"loan_principal_amount_cents\": 50000000\n}" response = http.request(request) puts response.read_body ``` ```java Lien filing request import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses/business_id/liens") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"debtors\": [\n {\n \"organization_name\": \"Acme Corporation\",\n \"addresses\": [\n {\n \"address_line1\": \"123 Main Street\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"postal_code\": \"94105\"\n }\n ]\n }\n ],\n \"state\": \"CA\",\n \"secured_parties\": [\n {\n \"organization_name\": \"First National Bank\",\n \"role\": \"assignee\",\n \"addresses\": [\n {\n \"address_line1\": \"456 Finance Avenue\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"postal_code\": \"90210\"\n }\n ]\n }\n ],\n \"collateral\": \"All business assets and inventory\",\n \"loan_principal_amount_cents\": 50000000\n}") .asString(); ``` ```php Lien filing request request('POST', 'https://api.middesk.com/v1/businesses/business_id/liens', [ 'body' => '{ "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 }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Lien filing request using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses/business_id/liens"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"debtors\": [\n {\n \"organization_name\": \"Acme Corporation\",\n \"addresses\": [\n {\n \"address_line1\": \"123 Main Street\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"postal_code\": \"94105\"\n }\n ]\n }\n ],\n \"state\": \"CA\",\n \"secured_parties\": [\n {\n \"organization_name\": \"First National Bank\",\n \"role\": \"assignee\",\n \"addresses\": [\n {\n \"address_line1\": \"456 Finance Avenue\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"postal_code\": \"90210\"\n }\n ]\n }\n ],\n \"collateral\": \"All business assets and inventory\",\n \"loan_principal_amount_cents\": 50000000\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Lien filing request import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "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 ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses/business_id/liens")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```