Sign in

v1

latestOpenAPI 3.1.02026-07-241695611.0 MB
Lien Filing

Patch Existing Lien Filing Submission

Patches an existing lien filing submission with new information provided by the user. This endpoint allows for the modification of lien filing submissions that are in a draft state.

This route manages both UCC-1 and UCC-3 lien filing types. For specific details on the request models for each type, please refer to the LienFilingSubmissionUpdateUCC1Request and LienFilingSubmissionUpdateUCC3Request schemas.

Users can update debtor and secured party information, as well as add or remove attachments related to the lien filing, depending on the filing type.

It is important to note that only lien filings in a draft state can be updated. Attempting to update a lien filing that has already been submitted will result in an error.

The updated information will be validated according to the lien filing requirements before being saved. If the validation fails, the update will not be processed, and an error message will be returned.

Successful updates will return the updated lien filing submission details.

patch/lien_submissions/{filing_id}

Path parameters

filing_idstring uuid required

The unique identifier of the lien filing submission to update.

The unique identifier of the lien filing submission to update.

Request body

OR

Example request

{
  "reference_data": "Filing for a 1967 Ford Mustang",
  "submission_filing_name": "My Lien Filing",
  "real_estate_info": {
    "real_estate_record_owner": {
      "mailing_address": "123 Main St",
      "city": "Springfield",
      "postal_code": "62701",
      "organization_name": "Acme Inc"
    }
  },
  "assigned_business_debtor": {
    "mailing_address": "123 Main St",
    "city": "Springfield",
    "postal_code": "62701",
    "organization_name": "Acme Inc"
  },
  "assigned_debtor": {
    "mailing_address": "123 Main St",
    "city": "Springfield",
    "postal_code": "62701",
    "organization_name": "Acme Inc"
  },
  "debtors": [
    {
      "capacity": "ESTATE",
      "city": "Springfield",
      "mailing_address": "123 Main St",
      "organization_name": "Acme Inc",
      "organization_type": "COOPERATIVE",
      "postal_code": "62701",
      "state": "IL",
      "type": "ORGANIZATION"
    }
  ],
  "secured_parties": [
    {
      "city": "Springfield",
      "mailing_address": "123 Main St",
      "organization_name": "Acme Inc",
      "organization_type": "COOPERATIVE",
      "postal_code": "62701",
      "state": "IL",
      "type": "ORGANIZATION"
    }
  ],
  "collateral_statements": {
    "text": "Commercial real estate located at 123 Business Blvd, Tech City, TX"
  }
}

Response

Successfully updated the lien filing submission record.

OR

Example response

{
  "reference_data": "Filing for a 1967 Ford Mustang",
  "submission_filing_name": "My Lien Filing",
  "real_estate_info": {
    "real_estate_record_owner": {
      "mailing_address": "123 Main St",
      "city": "Springfield",
      "postal_code": "62701",
      "organization_name": "Acme Inc"
    }
  },
  "assigned_business_debtor": {
    "mailing_address": "123 Main St",
    "city": "Springfield",
    "postal_code": "62701",
    "organization_name": "Acme Inc"
  },
  "assigned_debtor": {
    "mailing_address": "123 Main St",
    "city": "Springfield",
    "postal_code": "62701",
    "organization_name": "Acme Inc"
  },
  "debtors": [
    {
      "capacity": "ESTATE",
      "city": "Springfield",
      "id": "1663a025-cc7f-4d76-bc86-507827c71e53",
      "mailing_address": "123 Main St",
      "organization_name": "Acme Inc",
      "organization_type": "COOPERATIVE",
      "postal_code": "62701",
      "role": "Debtor",
      "state": "IL",
      "type": "ORGANIZATION"
    }
  ],
  "secured_parties": [
    {
      "city": "Springfield",
      "id": "60ed3211-fe62-4ef5-9256-c0c235adfd19",
      "is_assignor": null,
      "mailing_address": "123 Main St",
      "masked": null,
      "organization_name": "Acme Inc",
      "organization_type": "COOPERATIVE",
      "postal_code": "62701",
      "role": "Secured Party",
      "state": "IL",
      "type": "ORGANIZATION"
    }
  ],
  "collateral_statements": {
    "text": "Commercial real estate located at 123 Business Blvd, Tech City, TX"
  },
  "filing_number": "UCC1-1234567890",
  "filing_date": "2023-01-01",
  "lapse_date": "2024-04-20"
}