Create lien filings in batch

curl -X POST https://api.middesk.com/v1/businesses/business_id/liens/batch \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "liens": [
    {
      "state": "CA",
      "debtors": [
        {
          "organization_name": "Acme Corporation",
          "addresses": [
            {
              "address_line1": "123 Main Street",
              "city": "San Francisco",
              "state": "CA",
              "postal_code": "94105"
            }
          ]
        }
      ],
      "collateral": "All business assets and inventory",
      "loan_principal_amount_cents": 50000000
    },
    {
      "state": "TX",
      "debtors": [
        {
          "organization_name": "Acme Corporation",
          "addresses": [
            {
              "address_line1": "456 Commerce Street",
              "city": "Dallas",
              "state": "TX",
              "postal_code": "75201"
            }
          ]
        }
      ],
      "collateral": "All business assets and inventory",
      "loan_principal_amount_cents": 25000000
    }
  ]
}'

{
  "object": "list",
  "data": [
    {
      "object": "lien",
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "type": "ucc",
      "business_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "debtors": [
        {
          "organization_name": "Test Debtor LLC",
          "addresses": [
            {
              "full_address": "123 Main St, San Francisco, CA 94102",
              "address_line1": "123 Main St",
              "city": "San Francisco",
              "state": "CA",
              "postal_code": "94102"
            }
          ]
        }
      ],
      "secured_parties": [
        {
          "organization_name": "Example Secured Party",
          "addresses": [
            {
              "full_address": "456 Finance Ave, New York, NY 10001",
              "address_line1": "456 Finance Ave",
              "city": "New York",
              "state": "NY",
              "postal_code": "10001"
            }
          ]
        }
      ],
      "state": "CA",
      "status": "created",
      "collateral": "All business assets",
      "negative_pledge": false,
      "loan_principal_amount_cents": 100000,
      "status_category": "pending",
      "owner_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "owner_type": "Business",
      "filed_by_account": true
    },
    {
      "object": "lien",
      "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
      "type": "ucc",
      "business_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "debtors": [
        {
          "organization_name": "Test Debtor LLC",
          "addresses": [
            {
              "full_address": "123 Main St, San Francisco, CA 94102",
              "address_line1": "123 Main St",
              "city": "San Francisco",
              "state": "CA",
              "postal_code": "94102"
            }
          ]
        }
      ],
      "secured_parties": [
        {
          "organization_name": "Example Secured Party",
          "addresses": [
            {
              "full_address": "456 Finance Ave, New York, NY 10001",
              "address_line1": "456 Finance Ave",
              "city": "New York",
              "state": "NY",
              "postal_code": "10001"
            }
          ]
        }
      ],
      "state": "TX",
      "status": "created",
      "collateral": "All business assets",
      "negative_pledge": false,
      "loan_principal_amount_cents": 50000,
      "status_category": "pending",
      "owner_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "owner_type": "Business",
      "filed_by_account": true
    }
  ]
}

Creates multiple lien filings in a single request. Each entry is processed independently. Successful entries return lien objects, failed entries return per-item errors.

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.

lienslist of objectsRequired

Array of lien filing entries. Each entry creates one lien. Each entry must have a unique state. Maximum 50 entries per request.

Response

batch processed

Errors

422

Post V1businesses Business ID Liens Batch Request Unprocessable Entity Error