v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

Lien Filing

Create New Ucc1 Lien Filing Submission For Person

Creates a new lien filing submission against a specified person in a draft state. This endpoint enables clients to submit all necessary information required for a lien filing, including the type of filing, relevant parties (secured parties and debtors), and a comprehensive description of the collateral.

post/people/{person_id}/lien_submissions

Path parameters

person_idstring uuid required

The unique identifier of the person to file a lien against.

Example:e463c3ea-566f-4b4b-be2f-dcce254bc004

The unique identifier of the person to file a lien against.

Request body

reference_datastring nullable

Reference text that will show up in the UCC form under box 8 (OPTIONAL FILER REFERENCE DATA).

submission_filing_namestring nullable

A custom name for the filing (only filer's reference).

search_to_reflectboolean nullable

When set to true, a search will be conducted on the debtor post-filing to verify that the filing has been properly registered by the filing office.

email_contactstring nullable

This email will receive all correspondence concerning this lien filing.

miscellaneous_infostring nullable

Miscellaneous information associated with the lien filing submission.

filing_type'UCC1' required

Initial financing statement, which is the first filing of a lien.

state'AL' | 'AK' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DE' | 'DC' | 'FL' | 'GA' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY' | 'PR' | 'VI' | 'AE' | 'AA' | 'AP' | 'GU' | 'AS'

jurisdiction_countystring nullable

The county where the lien is being filed. This is typically the county where the debtor's property or collateral is located.

alternative_filing_type'TRANSMITTING_UTILITY' | 'MANUFACTURED_HOME' | 'PUBLIC_FINANCE' | 'NOT_APPLICABLE'

documentary_tax_stamp_requiredboolean nullable

Whether a documentary tax stamp is required for the lien filing submission. When set to true all Documentary Stamps due and payable or to become due and payable pursuant, have been paid. If set to false, the lien filing submission will not require a documentary tax stamp.

Enum for the tax exempt reason for a lien filing.

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 created a draft lien filing submission record.

reference_datastring nullable

Reference text that will show up in the UCC form under box 8 (OPTIONAL FILER REFERENCE DATA).

submission_filing_namestring nullable

A custom name for the filing (only filer's reference).

search_to_reflectboolean nullable

When set to true, a search will be conducted on the debtor post-filing to verify that the filing has been properly registered by the filing office.

email_contactstring nullable

This email will receive all correspondence concerning this lien filing.

miscellaneous_infostring nullable

Miscellaneous information associated with the lien filing submission.

filing_type'UCC1' required

Initial financing statement, which is the first filing of a lien.

jurisdiction_countystring nullable

The county where the lien is being filed. This is typically the county where the debtor's property or collateral is located.

alternative_filing_type'TRANSMITTING_UTILITY' | 'MANUFACTURED_HOME' | 'PUBLIC_FINANCE' | 'NOT_APPLICABLE'

principal_indebted_amountstring nullable

The principal indebted amount in the lien filing submission.

documentary_tax_stamp_requiredboolean nullable

Enum for the tax exempt reason for a lien filing.

idstring uuid

The unique identifier for the lien filing submission.

Enum class delineating the various stages of a lien filing submission's lifecycle.

filing_numberstring nullable

The filing number assigned to the lien, when the lien filing has been recorded by the jurisdiction. This is a unique identifier for the lien, and is used to reference the lien in subsequent transactions.

filing_datestring date nullable

The date when the lien filing was submitted to the jurisdiction.

lapse_datestring date nullable

The date when the lien will lapse. Assigned when the lien filing is submitted to the jurisdiction.

has_downloadable_documentboolean

Indicates whether a downloadable document (e.g., the filed lien in PDF format) is available for this lien filing submission. This is typically true when the lien filing has been officially recorded by the jurisdiction.

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