Create a lien for a business

var client = new RestClient("https://api.middesk.com/v1/businesses/business_id/liens");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"state\": \"CA\",\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  \"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);

{
  "object": "lien",
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "ucc",
  "business_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "debtors": [
    {
      "name": "Acme Corporation",
      "addresses": [
        {
          "full_address": "123 Main Street, San Francisco, CA 94105",
          "address_line1": "123 Main Street",
          "city": "San Francisco",
          "state": "CA",
          "postal_code": "94105"
        }
      ]
    }
  ],
  "secured_parties": [
    {
      "name": "First National Bank",
      "addresses": [
        {
          "full_address": "456 Finance Avenue, Los Angeles, CA 90210",
          "address_line1": "456 Finance Avenue",
          "city": "Los Angeles",
          "state": "CA",
          "postal_code": "90210"
        }
      ]
    }
  ],
  "state": "CA",
  "status": "created",
  "collateral": "All business assets and inventory",
  "negative_pledge": false,
  "loan_principal_amount_cents": 50000000,
  "packet_number": "PKT-12345",
  "status_category": "pending",
  "owner_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "owner_type": "Business"
}

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.

stateenumRequired

State where the lien will be filed

debtorslist of objectsRequired

Array of debtor details

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

Authentication

Path parameters

Request

Response

Errors