Create a lien for a business

curl -X POST https://api.middesk.com/v1/businesses/business_id/liens \
     -H "Content-Type: application/json" \
     -u "<username>:<password>" \
     -d '{
  "state": "CA",
  "debtors": [
    {
      "organization_name": "Acme Corporation",
      "addresses": [
        {
          "address_line1": "123 Main Street",
          "city": "San Francisco",
          "state": "CA",
          "postal_code": "94105"
        }
      ]
    }
  ],
  "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
}'

{
  "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

AuthorizationBasic

Basic authentication of the form Basic <username:password>.

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