Create a lien for a business

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
}'

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

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

Post V1businesses Business ID Liens Request Bad Request Error

403

Post V1businesses Business ID Liens Request Forbidden Error

404

Post V1businesses Business ID Liens Request Not Found Error