Sign in

v1

latestOpenAPI 3.1.02026-07-241695611.0 MB
Lien Filing

Create New Ucc1 Lien Filing Submission For Business

Creates a new lien filing submission against a specified business 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.

Upon successful creation, the system assigns a unique identifier to the lien filing draft, which can be utilized for future modifications or inquiries.

The creation process entails the validation of the submitted information, its association with the designated business entity, and the preparation of the filing for subsequent processing steps.

If the request body does not include secured parties, the system will attempt to generate the first secured party using the organization's lien filing preferences, if they are present in the organization's profile.

It's important to note that the actual filing with the appropriate jurisdiction does not occur at this stage; this endpoint essentially sets up the submission in a draft state, ready for submission through the POST /lien_submissions/{filing_id}/submit endpoint.

post/businesses/{business_id}/lien_submissions

Path parameters

business_idstring uuid required

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

Example:72de75e6-c47f-4b58-881f-002ff7f1c564

The unique identifier of the business 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_name_designation'AGLIEN' | 'BAILEE_BAILOR' | 'CONSIGNEE_CONSIGNOR' | 'LESSEE_LESSOR' | 'NON_UCC_FILING' | 'SELLER_BUYER' | 'LICENSEE' | 'DEBTOR_SECURED_PARTY'
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.

tax_exempt_reason'DEBTOR_COOPERATIVE_MARKETING_ASSOCIATION' | 'DEBTOR_CREDIT_UNION' | 'DEBTOR_TELEPHONE_COOPERATIVE' | 'GOVERNMENT_AGENCY' | 'JUDGEMENT_LIEN' | 'MUNICIPALITY' | 'REORGANIZATION' | 'SECURITIES' | 'STATE_AGENCY' | 'NOT_EXEMPT'

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.

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_name_designation'AGLIEN' | 'BAILEE_BAILOR' | 'CONSIGNEE_CONSIGNOR' | 'LESSEE_LESSOR' | 'NON_UCC_FILING' | 'SELLER_BUYER' | 'LICENSEE' | 'DEBTOR_SECURED_PARTY'
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

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.

tax_exempt_reason'DEBTOR_COOPERATIVE_MARKETING_ASSOCIATION' | 'DEBTOR_CREDIT_UNION' | 'DEBTOR_TELEPHONE_COOPERATIVE' | 'GOVERNMENT_AGENCY' | 'JUDGEMENT_LIEN' | 'MUNICIPALITY' | 'REORGANIZATION' | 'SECURITIES' | 'STATE_AGENCY' | 'NOT_EXEMPT'

Enum for the tax exempt reason for a lien filing.

idstring uuid

The unique identifier for the lien filing submission.

filing_status'Draft' | 'Requested' | 'InReview' | 'NeedsAttention' | 'Submitted' | 'Filed' | 'Cancelled'

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