---
title: "Fetch Existing Lien Filing"
method: GET
path: "/lien_submissions/{filing_id}"
tags: ["Lien Filing"]
---

# Fetch Existing Lien Filing

`GET /lien_submissions/{filing_id}`

Fetch an existing lien filing submission by its unique identifier.

This endpoint retrieves the details of a specific lien filing submission,
including the filing status, parties involved, and any attachments or collateral descriptions.

## Path parameters

- `filing_id` string, uuid, required — The unique identifier of the lien filing submission to fetch.

## Response `200`

The lien filing submission found.

- union
  - V1LienFilingSubmissionUCC1Response — Represents the response structure for a lien filing submission. This model includes all the details provided during the creation of a lien filing submission along with additional system-generated information such as the unique identifier, the current status of the submission, and the filing number if the lien has been recorded.
    - `reference_data` string, nullable — Reference text that will show up in the UCC form under box 8 (OPTIONAL FILER REFERENCE DATA).
    - `submission_filing_name` string, nullable — A custom name for the filing (only filer's reference).
    - `search_to_reflect` boolean, 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_contact` string, nullable — This email will receive all correspondence concerning this lien filing.
    - `real_estate_info` union — The real estate information associated with the lien filing submission.
      - V1LienFilingRealEstateInfo — This model represents the real estate record in a lien filing submission.
        - `type` 'FILE_IN_REAL_ESTATE_RECORDS', required — Indicates that this FINANCING STATEMENT is to be filed [for record] (or recorded) in the REAL ESTATE RECORDS.
        - `covers_timber` boolean, nullable — Whether the financing statement filed in the lien filing submission covers timber.
        - `covers_as_extracted_collateral` boolean, nullable — Whether the financing statement filed in the lien filing submission covers as-extracted collateral.
        - `filed_as_fixture` boolean, nullable — Whether the financing statement filed in the lien filing submission is filed as a fixture.
        - `real_estate_record_owner` union
          - V1LienFilingOrganizationRecordOwnerParty — Represents an organization record owner party involved in a lien filing.
            - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
            - `city` string, nullable — The city of the lien filing party's mailing address.
            - `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'
            - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
            - `organization_name` string, nullable — The name of the organization involved in the lien filing.
            - `organization_type` 'SOLE_PROPRIETORSHIP' | 'GENERAL_PARTNERSHIP' | 'LLC' | 'LLP' | 'LLLP' | 'LP' | 'C_CORPORATION' | 'S_CORPORATION' | 'B_CORPORATION' | 'NONPROFIT' | 'COOPERATIVE' | 'TRUST' | 'PROFESSIONAL_ASSOCIATION' | 'PROFESSIONAL_CORPORATION' | 'TRADE_NAME' | 'BANK' | 'CREDIT_UNION' | 'INSURANCE' | 'OTHER'
            - `type` 'ORGANIZATION', required — Specifies the party type as 'Organization' for the context of this lien filing, indicating that the party is an organization or entity rather than a person.
          - V1LienFilingIndividualRecordOwnerParty — Represents an individual record owner party involved in a lien filing.
            - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
            - `city` string, nullable — The city of the lien filing party's mailing address.
            - `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'
            - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
            - `suffix` string, nullable — The suffix of the individual involved in the lien filing, if applicable.
            - `last_name` string, nullable — The last name of the individual involved in the lien filing, if applicable.
            - `first_name` string, nullable — The first name of the individual involved in the lien filing, if applicable.
            - `middle_name` string, nullable — The middle name of the individual involved in the lien filing, if applicable.
            - `type` 'INDIVIDUAL', required — Specifies the party type as 'Individual' for the context of this lien filing, indicating that the party is a person rather than an organization or entity.
        - `real_estate_description` string, nullable — A description of the real estate.
      - V1LienFilingNoRealEstateInfo — This model represents the absence of real estate information associated with a lien filing.
        - `type` 'NO_REAL_ESTATE_INFO', required — Indicates that no real estate information is associated with the lien filing.
    - `miscellaneous_info` string, 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_county` string, nullable — The county where the lien is being filed. This is typically the county where the debtor's property or collateral is located.
    - `assigned_business_debtor` V1LienFilingAssignedBusinessDebtorPartyResponse — Represents the response structure for an assigned business debtor party in a lien filing. This model includes details about the business entity acting as a debtor, such as its unique identifier, organizational information, and mailing address. It also incorporates additional response-specific fields like the party's ID.
      - `id` string, uuid — The unique identifier assigned to the lien filing party.
      - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
      - `city` string, nullable — The city of the lien filing party's mailing address.
      - `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'
      - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
      - `organization_name` string, nullable — The name of the organization involved in the lien filing.
      - `organization_type` 'SOLE_PROPRIETORSHIP' | 'GENERAL_PARTNERSHIP' | 'LLC' | 'LLP' | 'LLLP' | 'LP' | 'C_CORPORATION' | 'S_CORPORATION' | 'B_CORPORATION' | 'NONPROFIT' | 'COOPERATIVE' | 'TRUST' | 'PROFESSIONAL_ASSOCIATION' | 'PROFESSIONAL_CORPORATION' | 'TRADE_NAME' | 'BANK' | 'CREDIT_UNION' | 'INSURANCE' | 'OTHER'
      - `type` 'ORGANIZATION', required — Specifies the party type as 'Organization' for the context of this lien filing, indicating that the party is an organization or entity rather than a person.
      - `capacity` 'ESTATE' | 'TRUST' | 'TRUSTEE' | 'NONE_OF_THE_ABOVE' — Defines the various capacities a debtor may assume in the context of a lien, aiding in the comprehension of their legal standing and obligations concerning the lien.
      - `business_id` string, uuid — A unique identifier assigned to the business entity (debtor) involved in the lien filing process.
      - `role` 'Debtor', required — Indicates the role of the party as 'Debtor', signifying their interest is protected by the lien.
    - `assigned_debtor` union — The debtor associated with the business against which the lien is filed. This debtor information is pre-filled based on the business details and cannot be modified (hence not appearing in POST and PUT requests).
      - V1LienFilingAssignedBusinessDebtorPartyResponse — Represents the response structure for an assigned business debtor party in a lien filing. This model includes details about the business entity acting as a debtor, such as its unique identifier, organizational information, and mailing address. It also incorporates additional response-specific fields like the party's ID.
        - `id` string, uuid — The unique identifier assigned to the lien filing party.
        - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
        - `city` string, nullable — The city of the lien filing party's mailing address.
        - `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'
        - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
        - `organization_name` string, nullable — The name of the organization involved in the lien filing.
        - `organization_type` 'SOLE_PROPRIETORSHIP' | 'GENERAL_PARTNERSHIP' | 'LLC' | 'LLP' | 'LLLP' | 'LP' | 'C_CORPORATION' | 'S_CORPORATION' | 'B_CORPORATION' | 'NONPROFIT' | 'COOPERATIVE' | 'TRUST' | 'PROFESSIONAL_ASSOCIATION' | 'PROFESSIONAL_CORPORATION' | 'TRADE_NAME' | 'BANK' | 'CREDIT_UNION' | 'INSURANCE' | 'OTHER'
        - `type` 'ORGANIZATION', required — Specifies the party type as 'Organization' for the context of this lien filing, indicating that the party is an organization or entity rather than a person.
        - `capacity` 'ESTATE' | 'TRUST' | 'TRUSTEE' | 'NONE_OF_THE_ABOVE' — Defines the various capacities a debtor may assume in the context of a lien, aiding in the comprehension of their legal standing and obligations concerning the lien.
        - `business_id` string, uuid — A unique identifier assigned to the business entity (debtor) involved in the lien filing process.
        - `role` 'Debtor', required — Indicates the role of the party as 'Debtor', signifying their interest is protected by the lien.
      - V1LienFilingAssignedPersonDebtorPartyResponse — Represents the response structure for an assigned person debtor party in a lien filing. This model includes details about the person acting as a debtor, such as its unique identifier, organizational information, and mailing address. It also incorporates additional response-specific fields like the party's ID.
        - `id` string, uuid — The unique identifier assigned to the lien filing party.
        - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
        - `city` string, nullable — The city of the lien filing party's mailing address.
        - `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'
        - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
        - `suffix` string, nullable — The suffix of the individual involved in the lien filing, if applicable.
        - `last_name` string, nullable — The last name of the individual involved in the lien filing, if applicable.
        - `first_name` string, nullable — The first name of the individual involved in the lien filing, if applicable.
        - `middle_name` string, nullable — The middle name of the individual involved in the lien filing, if applicable.
        - `type` 'INDIVIDUAL', required — Specifies the party type as 'Individual' for the context of this lien filing, indicating that the party is a person rather than an organization or entity.
        - `capacity` 'ESTATE' | 'TRUST' | 'TRUSTEE' | 'NONE_OF_THE_ABOVE' — Defines the various capacities a debtor may assume in the context of a lien, aiding in the comprehension of their legal standing and obligations concerning the lien.
        - `person_id` string, uuid — A unique identifier assigned to the individual (debtor) involved in the lien filing process.
        - `role` 'Debtor', required — Indicates the role of the party as 'Debtor', signifying their interest is protected by the lien.
    - `debtors` union[], nullable — An enumeration of debtors implicated in the lien filing process. It is imperative to omit the debtor correlated with the business profile against which the lien is being filed. Such a debtor is automatically deduced and pre-populated based on the business_id present in the URL.
      - union
        - V1LienFilingOrganizationDebtorPartyResponse — Represents the response structure for an organization acting as a debtor in a lien filing. This model encapsulates detailed information about an organizational debtor, including its identification, contact details, and specific attributes relevant to its role in the lien. It is designed to provide a comprehensive view of the debtor's information as returned by the API in response to lien-related queries or operations.
          - `id` string, uuid — The unique identifier assigned to the lien filing party.
          - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
          - `city` string, nullable — The city of the lien filing party's mailing address.
          - `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'
          - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
          - `capacity` 'ESTATE' | 'TRUST' | 'TRUSTEE' | 'NONE_OF_THE_ABOVE' — Defines the various capacities a debtor may assume in the context of a lien, aiding in the comprehension of their legal standing and obligations concerning the lien.
          - `organization_name` string, nullable — The name of the organization involved in the lien filing.
          - `organization_type` 'SOLE_PROPRIETORSHIP' | 'GENERAL_PARTNERSHIP' | 'LLC' | 'LLP' | 'LLLP' | 'LP' | 'C_CORPORATION' | 'S_CORPORATION' | 'B_CORPORATION' | 'NONPROFIT' | 'COOPERATIVE' | 'TRUST' | 'PROFESSIONAL_ASSOCIATION' | 'PROFESSIONAL_CORPORATION' | 'TRADE_NAME' | 'BANK' | 'CREDIT_UNION' | 'INSURANCE' | 'OTHER'
          - `type` 'ORGANIZATION', required — Specifies the party type as 'Organization' for the context of this lien filing, indicating that the party is an organization or entity rather than a person.
          - `role` 'Debtor', required — Indicates the role of the party as 'Debtor', signifying their interest is protected by the lien.
        - V1LienFilingIndividualDebtorPartyResponse — Represents the response structure for an individual debtor party in a lien filing. This model encapsulates detailed information about an individual acting as a debtor, including their identification, contact details, and specific attributes relevant to their role in the lien. It is designed to provide a comprehensive view of the individual debtor's information as returned by the API in response to lien-related queries or operations.
          - `id` string, uuid — The unique identifier assigned to the lien filing party.
          - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
          - `city` string, nullable — The city of the lien filing party's mailing address.
          - `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'
          - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
          - `capacity` 'ESTATE' | 'TRUST' | 'TRUSTEE' | 'NONE_OF_THE_ABOVE' — Defines the various capacities a debtor may assume in the context of a lien, aiding in the comprehension of their legal standing and obligations concerning the lien.
          - `suffix` string, nullable — The suffix of the individual involved in the lien filing, if applicable.
          - `last_name` string, nullable — The last name of the individual involved in the lien filing, if applicable.
          - `first_name` string, nullable — The first name of the individual involved in the lien filing, if applicable.
          - `middle_name` string, nullable — The middle name of the individual involved in the lien filing, if applicable.
          - `type` 'INDIVIDUAL', required — Specifies the party type as 'Individual' for the context of this lien filing, indicating that the party is a person rather than an organization or entity.
          - `role` 'Debtor', required — Indicates the role of the party as 'Debtor', signifying their interest is protected by the lien.
    - `secured_parties` union[], nullable — A list of secured parties involved in the lien filing.
      - union
        - V1LienFilingOrganizationSecuredPartyResponse — Represents the response structure for an organization acting as a secured party in a lien filing. This model encapsulates detailed information about an organizational secured party, including their identification, contact details, and specific attributes relevant to their role in the lien. It is designed to provide a comprehensive view of the secured party's information as returned by the API in response to lien-related queries or operations.
          - `id` string, uuid — The unique identifier assigned to the lien filing party.
          - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
          - `city` string, nullable — The city of the lien filing party's mailing address.
          - `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'
          - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
          - `masked` boolean, nullable — A flag to indicate if the secured party should be masked when filing a lien.
          - `is_assignor` boolean, nullable — Whether the secured party is the assignor of the lien.
          - `organization_name` string, nullable — The name of the organization involved in the lien filing.
          - `organization_type` 'SOLE_PROPRIETORSHIP' | 'GENERAL_PARTNERSHIP' | 'LLC' | 'LLP' | 'LLLP' | 'LP' | 'C_CORPORATION' | 'S_CORPORATION' | 'B_CORPORATION' | 'NONPROFIT' | 'COOPERATIVE' | 'TRUST' | 'PROFESSIONAL_ASSOCIATION' | 'PROFESSIONAL_CORPORATION' | 'TRADE_NAME' | 'BANK' | 'CREDIT_UNION' | 'INSURANCE' | 'OTHER'
          - `type` 'ORGANIZATION', required — Specifies the party type as 'Organization' for the context of this lien filing, indicating that the party is an organization or entity rather than a person.
          - `role` 'Secured Party', required — Indicates the role of the party as 'Secured', signifying their interest is protected by the lien.
        - V1LienFilingIndividualSecuredPartyResponse — Represents the response structure for an individual secured party in a lien filing. This model encapsulates detailed information about an individual acting as a secured party, including their identification, contact details, and specific attributes relevant to their role in the lien. It is designed to provide a comprehensive view of the individual secured party's information as returned by the API in response to lien-related queries or operations.
          - `id` string, uuid — The unique identifier assigned to the lien filing party.
          - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
          - `city` string, nullable — The city of the lien filing party's mailing address.
          - `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'
          - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
          - `masked` boolean, nullable — A flag to indicate if the secured party should be masked when filing a lien.
          - `is_assignor` boolean, nullable — Whether the secured party is the assignor of the lien.
          - `suffix` string, nullable — The suffix of the individual involved in the lien filing, if applicable.
          - `last_name` string, nullable — The last name of the individual involved in the lien filing, if applicable.
          - `first_name` string, nullable — The first name of the individual involved in the lien filing, if applicable.
          - `middle_name` string, nullable — The middle name of the individual involved in the lien filing, if applicable.
          - `type` 'INDIVIDUAL', required — Specifies the party type as 'Individual' for the context of this lien filing, indicating that the party is a person rather than an organization or entity.
          - `role` 'Secured Party', required — Indicates the role of the party as 'Secured', signifying their interest is protected by the lien.
    - `collateral_statements` union — This field allows for collateral statements to be provided either as plain text or as one or more document attachments, offering flexibility in how detailed information or evidence related to the lien's collateral is presented.
      - V1LienFilingCollateralStatementText — This structure represents the schema for a collateral statement in the form of text provided for a lien filing submission.
        - `collateral_statement_designation` 'NONE' | 'TRUST' | 'PERSONAL_REPRESENTATIVE' — Enumeration of possible designations for a lien collateral statement.
        - `text` string, nullable — A plain text description of the collateral.
        - `type` 'TEXT', required — When using this type, the structure represents the schema for a collateral statement in the form of text provided for a lien filing submission. Setting the `"type":"TEXT"` will remove all previously uploaded attachments for this lien filing submission.
      - V1LienFilingCollateralStatementAttachmentsResponse — This model represents a collateral statement for a lien filing that includes one or more attachments (PDF documents), to provide additional details or evidence related to the collateral. Each attachment is identified by a unique ID and has an associated filename.
        - `collateral_statement_designation` 'NONE' | 'TRUST' | 'PERSONAL_REPRESENTATIVE' — Enumeration of possible designations for a lien collateral statement.
        - `attachments` V1LienFilingAttachment[] — A list of PDF filenames as attachments.
          - `id` string, uuid, required — The unique identifier of the lien filing attachment.
          - `document_filename` string, required — The filename of the document associated with this lien filing attachment.
        - `type` 'ATTACHMENTS', required — When using this type this structure represents a collateral statement for a lien filing that includes one or more attachments (PDF documents), to provide additional details or evidence related to the collateral. Each attachment is identified by a unique ID and has an associated filename.
    - `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_amount` string, nullable — The principal indebted amount in the lien filing submission.
    - `documentary_tax_stamp_required` boolean, 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.
    - `id` string, 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_number` string, 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_date` string, date, nullable — The date when the lien filing was submitted to the jurisdiction.
    - `lapse_date` string, date, nullable — The date when the lien will lapse. Assigned when the lien filing is submitted to the jurisdiction.
    - `has_downloadable_document` boolean — 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.
  - V1LienFilingSubmissionUCC3Response
    - `reference_data` string, nullable — Reference text that will show up in the UCC form under box 8 (OPTIONAL FILER REFERENCE DATA).
    - `submission_filing_name` string, nullable — A custom name for the filing (only filer's reference).
    - `search_to_reflect` boolean, 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_contact` string, nullable — This email will receive all correspondence concerning this lien filing.
    - `real_estate_info` union — The real estate information associated with the lien filing submission.
      - V1LienFilingRealEstateInfo — This model represents the real estate record in a lien filing submission.
        - `type` 'FILE_IN_REAL_ESTATE_RECORDS', required — Indicates that this FINANCING STATEMENT is to be filed [for record] (or recorded) in the REAL ESTATE RECORDS.
        - `covers_timber` boolean, nullable — Whether the financing statement filed in the lien filing submission covers timber.
        - `covers_as_extracted_collateral` boolean, nullable — Whether the financing statement filed in the lien filing submission covers as-extracted collateral.
        - `filed_as_fixture` boolean, nullable — Whether the financing statement filed in the lien filing submission is filed as a fixture.
        - `real_estate_record_owner` union
          - V1LienFilingOrganizationRecordOwnerParty — Represents an organization record owner party involved in a lien filing.
            - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
            - `city` string, nullable — The city of the lien filing party's mailing address.
            - `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'
            - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
            - `organization_name` string, nullable — The name of the organization involved in the lien filing.
            - `organization_type` 'SOLE_PROPRIETORSHIP' | 'GENERAL_PARTNERSHIP' | 'LLC' | 'LLP' | 'LLLP' | 'LP' | 'C_CORPORATION' | 'S_CORPORATION' | 'B_CORPORATION' | 'NONPROFIT' | 'COOPERATIVE' | 'TRUST' | 'PROFESSIONAL_ASSOCIATION' | 'PROFESSIONAL_CORPORATION' | 'TRADE_NAME' | 'BANK' | 'CREDIT_UNION' | 'INSURANCE' | 'OTHER'
            - `type` 'ORGANIZATION', required — Specifies the party type as 'Organization' for the context of this lien filing, indicating that the party is an organization or entity rather than a person.
          - V1LienFilingIndividualRecordOwnerParty — Represents an individual record owner party involved in a lien filing.
            - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
            - `city` string, nullable — The city of the lien filing party's mailing address.
            - `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'
            - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
            - `suffix` string, nullable — The suffix of the individual involved in the lien filing, if applicable.
            - `last_name` string, nullable — The last name of the individual involved in the lien filing, if applicable.
            - `first_name` string, nullable — The first name of the individual involved in the lien filing, if applicable.
            - `middle_name` string, nullable — The middle name of the individual involved in the lien filing, if applicable.
            - `type` 'INDIVIDUAL', required — Specifies the party type as 'Individual' for the context of this lien filing, indicating that the party is a person rather than an organization or entity.
        - `real_estate_description` string, nullable — A description of the real estate.
      - V1LienFilingNoRealEstateInfo — This model represents the absence of real estate information associated with a lien filing.
        - `type` 'NO_REAL_ESTATE_INFO', required — Indicates that no real estate information is associated with the lien filing.
    - `miscellaneous_info` string, nullable — Miscellaneous information associated with the lien filing submission.
    - `filing_type` 'UCC3', required — Amendment or continuation of a previously filed financing statement.
    - `amendment_action` union — The action to be taken for the UCC-3 filing.
      - V1LienFilingUCC3TerminationAction — Represents a UCC-3 termination filing. This model defines the structure for a termination action in a UCC-3 filing. It is used to indicate the termination of a previously filed UCC-1 financing statement, signifying that the secured party no longer claims a security interest under that statement.
        - `type` 'TERMINATION', required — Indicates that this is a termination action for a UCC-3 filing. A termination statement is used to indicate that the secured party no longer claims a security interest under the financing statement.
      - V1LienFilingUCC3ContinuationAction — Represents a UCC-3 continuation filing. This model defines the structure for a continuation action in a UCC-3 filing. It is used to extend the effectiveness of a previously filed UCC-1 financing statement. > **NOTE:** A Continuation may be filed within 6 months of a filing's lapse date.
        - `type` 'CONTINUATION', required — Indicates that this is a continuation action for a UCC-3 filing. A continuation statement is used to extend the effectiveness of the financing statement for an additional period of time. > **NOTE:** A Continuation may be filed within 6 months of a filing's lapse date.
      - V1LienFilingUCC3AssignmentActionResponse
        - `type` 'ASSIGNMENT', required — Indicates that this is an assignment action for a UCC-3 filing. An assignment is used to transfer some or all of the secured party's rights under the financing statement to another party.
        - `assignment` union — Specifies the details of the assignment action. This can be either a partial assignment, where only some rights are transferred, or a full assignment, where all rights are transferred to the new secured party.
          - V1LienFilingUCC3PartialAssignmentResponse
            - `type` 'PARTIAL', required — Indicates a partial assignment of the lien filing. In a partial assignment: - Only a portion of the interest in the collateral is transferred to a new secured party. - The original secured party retains some rights to the collateral. - Both the original and new secured parties may have rights to take actions related to the financing statement, but only for their respective portions of the collateral.
            - `secured_parties` union[], nullable — An enumeration of secured parties implicated in the lien filing process.
              - …
            - `collateral_statements` union — This field allows for collateral statements to be provided either as plain text or as one or more document attachments, offering flexibility in how detailed information or evidence related to the lien's collateral is presented. > **NOTE:** Attachments for lien filing submissions are managed through separate attachment management routes specific to lien filings. These routes allow for the upload, retrieval, and deletion of attachments associated with a lien filing. To include attachments in the collateral statements, set the `collateral_statements` field with `type="ATTACHMENTS"` and use the appropriate attachment management endpoints.
              - …
          - V1LienFilingUCC3FullAssignmentResponse
            - `type` 'FULL', required — Indicates a full assignment of the lien filing. In a full assignment: - The entire interest in the collateral is transferred to a new secured party. - The original secured party relinquishes all rights to the collateral. - All future actions related to the financing statement will be handled by the new secured party.
            - `secured_parties` union[], nullable — An enumeration of secured parties implicated in the lien filing process.
              - …
      - V1LienFilingUCC3DebtorAmendmentActionResponse
        - `type` 'DEBTOR_AMENDMENT', required — Indicates that this is a debtor amendment action for a UCC-3 filing. A debtor amendment is used to add, delete, or modify information about a debtor in the financing statement.
        - `amendment` union — Specifies the type of debtor amendment action to be performed. This can be adding a new debtor, editing an existing debtor's information, or deleting a debtor from the financing statement.
          - V1LienFilingUCC3AddDebtorAmendmentResponse — Represents an amendment to add a debtor in a UCC-3 filing. This model is used to add a new debtor to an existing financing statement. It includes details about the debtor being added to the UCC-3 amendment.
            - `type` 'ADD', required — Indicates that this is an add debtor action for a UCC-3 filing. An add debtor action is used to add a new debtor to the financing statement.
            - `debtors` union[] — An enumeration of debtors implicated in the lien filing process. It is imperative to omit the debtor correlated with the business profile against which the lien is being filed.
              - …
          - V1LienFilingUCC3EditDebtorAmendmentResponse
            - `type` 'EDIT', required — Indicates that this is an edit debtor action for a UCC-3 filing. An edit debtor action is used to edit an existing debtor in the financing statement.
            - `amending_debtors` V1LienFilingUCC3AmendingDebtorResponse[] — A list of debtors to be amended in the UCC-3 filing. Each entry contains the position of the debtor in the original filing and the new debtor information.
              - …
          - V1LienFilingUCC3DeleteDebtorAmendmentResponse
            - `type` 'DELETE', required — Indicates that this is a delete debtor action for a UCC-3 filing. A delete debtor action is used to delete an existing debtor in the financing statement.
            - `deleted_debtors` union[] — A list of the debtors to be deleted in the UCC-3 filing.
              - …
      - V1LienFilingUCC3SecuredPartyAmendmentActionResponse — Represents a response model for a UCC-3 secured party amendment filing. This schema defines the structure for a secured party amendment action in a UCC-3 filing. It is used to add, delete, or modify information about a secured party in a previously filed financing statement.
        - `type` 'SECURED_PARTY_AMENDMENT', required — Indicates that this is a secured party amendment action for a UCC-3 filing. A secured party amendment is used to add, delete, or modify information about a secured party in the financing statement.
        - `amendment` union — Specifies the type of secured party amendment action to be performed. This can be adding a new secured party, editing an existing secured party's information, or deleting a secured party from the financing statement.
          - V1LienFilingUCC3AddSecuredPartyAmendmentResponse
            - `type` 'ADD', required — Indicates that this is an add debtor action for a UCC-3 filing. An add debtor action is used to add a new debtor to the financing statement.
            - `secured_parties` union[] — An enumeration of secured parties implicated in the lien filing process.
              - …
          - V1LienFilingUCC3EditSecuredPartyAmendmentResponse
            - `type` 'EDIT', required — Indicates that this is an edit secured party action for a UCC-3 filing. An edit secured party action is used to edit an existing secured party in the financing statement.
            - `amending_secured_parties` V1LienFilingUCC3AmendingSecuredPartyResponse[], nullable — A list of secured parties to be amended in the UCC-3 filing. Each entry contains the position of the secured party in the original filing and the new secured party information.
              - …
          - V1LienFilingUCC3DeleteSecuredPartyAmendmentResponse
            - `type` 'DELETE', required — Indicates that this is a delete secured party action for a UCC-3 filing. A delete secured party action is used to delete an existing secured party in the financing statement.
            - `deleted_secured_parties` union[] — A list of the secured parties to be deleted in the UCC-3 filing.
              - …
      - V1LienFilingUCC3CollateralAmendmentActionResponse — Represents the response structure for a UCC-3 collateral amendment action. This model includes details about the collateral amendment, such as the type of amendment and the updated collateral statements. It provides a comprehensive view of the changes made to the collateral information in a UCC-3 filing.
        - `type` 'COLLATERAL_AMENDMENT', required — Indicates that this is a collateral amendment action for a UCC-3 filing. A collateral amendment is used to add, delete, or modify information about the collateral described in the financing statement.
        - `collateral_amendment_type` 'ADD' | 'RESTATE' | 'DELETE' — Enum representing the types of amendments that can be made to collateral in a lien filing. This enum defines the possible actions that can be taken when amending information about collateral in a lien filing.
        - `collateral_statements` union — This field allows for collateral statements to be provided either as plain text or as one or more document attachments, offering flexibility in how detailed information or evidence related to the lien's collateral is presented.
          - V1LienFilingCollateralStatementText — This structure represents the schema for a collateral statement in the form of text provided for a lien filing submission.
            - `collateral_statement_designation` 'NONE' | 'TRUST' | 'PERSONAL_REPRESENTATIVE' — Enumeration of possible designations for a lien collateral statement.
            - `text` string, nullable — A plain text description of the collateral.
            - `type` 'TEXT', required — When using this type, the structure represents the schema for a collateral statement in the form of text provided for a lien filing submission. Setting the `"type":"TEXT"` will remove all previously uploaded attachments for this lien filing submission.
          - V1LienFilingCollateralStatementAttachmentsResponse — This model represents a collateral statement for a lien filing that includes one or more attachments (PDF documents), to provide additional details or evidence related to the collateral. Each attachment is identified by a unique ID and has an associated filename.
            - `collateral_statement_designation` 'NONE' | 'TRUST' | 'PERSONAL_REPRESENTATIVE' — Enumeration of possible designations for a lien collateral statement.
            - `attachments` V1LienFilingAttachment[] — A list of PDF filenames as attachments.
              - …
            - `type` 'ATTACHMENTS', required — When using this type this structure represents a collateral statement for a lien filing that includes one or more attachments (PDF documents), to provide additional details or evidence related to the collateral. Each attachment is identified by a unique ID and has an associated filename.
    - `authorizing_party` union — The party authorizing the UCC-3 filing amendment. This can be either the debtor or the secured party.
      - V1LienFilingOrganizationSecuredPartyResponse — Represents the response structure for an organization acting as a secured party in a lien filing. This model encapsulates detailed information about an organizational secured party, including their identification, contact details, and specific attributes relevant to their role in the lien. It is designed to provide a comprehensive view of the secured party's information as returned by the API in response to lien-related queries or operations.
        - `id` string, uuid — The unique identifier assigned to the lien filing party.
        - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
        - `city` string, nullable — The city of the lien filing party's mailing address.
        - `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'
        - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
        - `masked` boolean, nullable — A flag to indicate if the secured party should be masked when filing a lien.
        - `is_assignor` boolean, nullable — Whether the secured party is the assignor of the lien.
        - `organization_name` string, nullable — The name of the organization involved in the lien filing.
        - `organization_type` 'SOLE_PROPRIETORSHIP' | 'GENERAL_PARTNERSHIP' | 'LLC' | 'LLP' | 'LLLP' | 'LP' | 'C_CORPORATION' | 'S_CORPORATION' | 'B_CORPORATION' | 'NONPROFIT' | 'COOPERATIVE' | 'TRUST' | 'PROFESSIONAL_ASSOCIATION' | 'PROFESSIONAL_CORPORATION' | 'TRADE_NAME' | 'BANK' | 'CREDIT_UNION' | 'INSURANCE' | 'OTHER'
        - `type` 'ORGANIZATION', required — Specifies the party type as 'Organization' for the context of this lien filing, indicating that the party is an organization or entity rather than a person.
        - `role` 'Secured Party', required — Indicates the role of the party as 'Secured', signifying their interest is protected by the lien.
      - V1LienFilingIndividualSecuredPartyResponse — Represents the response structure for an individual secured party in a lien filing. This model encapsulates detailed information about an individual acting as a secured party, including their identification, contact details, and specific attributes relevant to their role in the lien. It is designed to provide a comprehensive view of the individual secured party's information as returned by the API in response to lien-related queries or operations.
        - `id` string, uuid — The unique identifier assigned to the lien filing party.
        - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
        - `city` string, nullable — The city of the lien filing party's mailing address.
        - `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'
        - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
        - `masked` boolean, nullable — A flag to indicate if the secured party should be masked when filing a lien.
        - `is_assignor` boolean, nullable — Whether the secured party is the assignor of the lien.
        - `suffix` string, nullable — The suffix of the individual involved in the lien filing, if applicable.
        - `last_name` string, nullable — The last name of the individual involved in the lien filing, if applicable.
        - `first_name` string, nullable — The first name of the individual involved in the lien filing, if applicable.
        - `middle_name` string, nullable — The middle name of the individual involved in the lien filing, if applicable.
        - `type` 'INDIVIDUAL', required — Specifies the party type as 'Individual' for the context of this lien filing, indicating that the party is a person rather than an organization or entity.
        - `role` 'Secured Party', required — Indicates the role of the party as 'Secured', signifying their interest is protected by the lien.
      - V1LienFilingOrganizationDebtorPartyResponse — Represents the response structure for an organization acting as a debtor in a lien filing. This model encapsulates detailed information about an organizational debtor, including its identification, contact details, and specific attributes relevant to its role in the lien. It is designed to provide a comprehensive view of the debtor's information as returned by the API in response to lien-related queries or operations.
        - `id` string, uuid — The unique identifier assigned to the lien filing party.
        - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
        - `city` string, nullable — The city of the lien filing party's mailing address.
        - `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'
        - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
        - `capacity` 'ESTATE' | 'TRUST' | 'TRUSTEE' | 'NONE_OF_THE_ABOVE' — Defines the various capacities a debtor may assume in the context of a lien, aiding in the comprehension of their legal standing and obligations concerning the lien.
        - `organization_name` string, nullable — The name of the organization involved in the lien filing.
        - `organization_type` 'SOLE_PROPRIETORSHIP' | 'GENERAL_PARTNERSHIP' | 'LLC' | 'LLP' | 'LLLP' | 'LP' | 'C_CORPORATION' | 'S_CORPORATION' | 'B_CORPORATION' | 'NONPROFIT' | 'COOPERATIVE' | 'TRUST' | 'PROFESSIONAL_ASSOCIATION' | 'PROFESSIONAL_CORPORATION' | 'TRADE_NAME' | 'BANK' | 'CREDIT_UNION' | 'INSURANCE' | 'OTHER'
        - `type` 'ORGANIZATION', required — Specifies the party type as 'Organization' for the context of this lien filing, indicating that the party is an organization or entity rather than a person.
        - `role` 'Debtor', required — Indicates the role of the party as 'Debtor', signifying their interest is protected by the lien.
      - V1LienFilingIndividualDebtorPartyResponse — Represents the response structure for an individual debtor party in a lien filing. This model encapsulates detailed information about an individual acting as a debtor, including their identification, contact details, and specific attributes relevant to their role in the lien. It is designed to provide a comprehensive view of the individual debtor's information as returned by the API in response to lien-related queries or operations.
        - `id` string, uuid — The unique identifier assigned to the lien filing party.
        - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
        - `city` string, nullable — The city of the lien filing party's mailing address.
        - `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'
        - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
        - `capacity` 'ESTATE' | 'TRUST' | 'TRUSTEE' | 'NONE_OF_THE_ABOVE' — Defines the various capacities a debtor may assume in the context of a lien, aiding in the comprehension of their legal standing and obligations concerning the lien.
        - `suffix` string, nullable — The suffix of the individual involved in the lien filing, if applicable.
        - `last_name` string, nullable — The last name of the individual involved in the lien filing, if applicable.
        - `first_name` string, nullable — The first name of the individual involved in the lien filing, if applicable.
        - `middle_name` string, nullable — The middle name of the individual involved in the lien filing, if applicable.
        - `type` 'INDIVIDUAL', required — Specifies the party type as 'Individual' for the context of this lien filing, indicating that the party is a person rather than an organization or entity.
        - `role` 'Debtor', required — Indicates the role of the party as 'Debtor', signifying their interest is protected by the lien.
      - V1LienFilingAssignedBusinessDebtorPartyResponse — Represents the response structure for an assigned business debtor party in a lien filing. This model includes details about the business entity acting as a debtor, such as its unique identifier, organizational information, and mailing address. It also incorporates additional response-specific fields like the party's ID.
        - `id` string, uuid — The unique identifier assigned to the lien filing party.
        - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
        - `city` string, nullable — The city of the lien filing party's mailing address.
        - `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'
        - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
        - `organization_name` string, nullable — The name of the organization involved in the lien filing.
        - `organization_type` 'SOLE_PROPRIETORSHIP' | 'GENERAL_PARTNERSHIP' | 'LLC' | 'LLP' | 'LLLP' | 'LP' | 'C_CORPORATION' | 'S_CORPORATION' | 'B_CORPORATION' | 'NONPROFIT' | 'COOPERATIVE' | 'TRUST' | 'PROFESSIONAL_ASSOCIATION' | 'PROFESSIONAL_CORPORATION' | 'TRADE_NAME' | 'BANK' | 'CREDIT_UNION' | 'INSURANCE' | 'OTHER'
        - `type` 'ORGANIZATION', required — Specifies the party type as 'Organization' for the context of this lien filing, indicating that the party is an organization or entity rather than a person.
        - `capacity` 'ESTATE' | 'TRUST' | 'TRUSTEE' | 'NONE_OF_THE_ABOVE' — Defines the various capacities a debtor may assume in the context of a lien, aiding in the comprehension of their legal standing and obligations concerning the lien.
        - `business_id` string, uuid — A unique identifier assigned to the business entity (debtor) involved in the lien filing process.
        - `role` 'Debtor', required — Indicates the role of the party as 'Debtor', signifying their interest is protected by the lien.
      - V1LienFilingAssignedPersonDebtorPartyResponse — Represents the response structure for an assigned person debtor party in a lien filing. This model includes details about the person acting as a debtor, such as its unique identifier, organizational information, and mailing address. It also incorporates additional response-specific fields like the party's ID.
        - `id` string, uuid — The unique identifier assigned to the lien filing party.
        - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
        - `city` string, nullable — The city of the lien filing party's mailing address.
        - `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'
        - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
        - `suffix` string, nullable — The suffix of the individual involved in the lien filing, if applicable.
        - `last_name` string, nullable — The last name of the individual involved in the lien filing, if applicable.
        - `first_name` string, nullable — The first name of the individual involved in the lien filing, if applicable.
        - `middle_name` string, nullable — The middle name of the individual involved in the lien filing, if applicable.
        - `type` 'INDIVIDUAL', required — Specifies the party type as 'Individual' for the context of this lien filing, indicating that the party is a person rather than an organization or entity.
        - `capacity` 'ESTATE' | 'TRUST' | 'TRUSTEE' | 'NONE_OF_THE_ABOVE' — Defines the various capacities a debtor may assume in the context of a lien, aiding in the comprehension of their legal standing and obligations concerning the lien.
        - `person_id` string, uuid — A unique identifier assigned to the individual (debtor) involved in the lien filing process.
        - `role` 'Debtor', required — Indicates the role of the party as 'Debtor', signifying their interest is protected by the lien.
    - `id` string, 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_number` string, 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_date` string, date, nullable — The date when the lien filing was submitted to the jurisdiction.
    - `lapse_date` string, date, nullable — The date when the lien will lapse. Assigned when the lien filing is submitted to the jurisdiction.
    - `has_downloadable_document` boolean — 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.
    - `amending_filing` V1LienFilingSubmissionUCC1Response — Represents the response structure for a lien filing submission. This model includes all the details provided during the creation of a lien filing submission along with additional system-generated information such as the unique identifier, the current status of the submission, and the filing number if the lien has been recorded.
      - `reference_data` string, nullable — Reference text that will show up in the UCC form under box 8 (OPTIONAL FILER REFERENCE DATA).
      - `submission_filing_name` string, nullable — A custom name for the filing (only filer's reference).
      - `search_to_reflect` boolean, 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_contact` string, nullable — This email will receive all correspondence concerning this lien filing.
      - `real_estate_info` union — The real estate information associated with the lien filing submission.
        - V1LienFilingRealEstateInfo — This model represents the real estate record in a lien filing submission.
          - `type` 'FILE_IN_REAL_ESTATE_RECORDS', required — Indicates that this FINANCING STATEMENT is to be filed [for record] (or recorded) in the REAL ESTATE RECORDS.
          - `covers_timber` boolean, nullable — Whether the financing statement filed in the lien filing submission covers timber.
          - `covers_as_extracted_collateral` boolean, nullable — Whether the financing statement filed in the lien filing submission covers as-extracted collateral.
          - `filed_as_fixture` boolean, nullable — Whether the financing statement filed in the lien filing submission is filed as a fixture.
          - `real_estate_record_owner` union
            - V1LienFilingOrganizationRecordOwnerParty — Represents an organization record owner party involved in a lien filing.
              - …
            - V1LienFilingIndividualRecordOwnerParty — Represents an individual record owner party involved in a lien filing.
              - …
          - `real_estate_description` string, nullable — A description of the real estate.
        - V1LienFilingNoRealEstateInfo — This model represents the absence of real estate information associated with a lien filing.
          - `type` 'NO_REAL_ESTATE_INFO', required — Indicates that no real estate information is associated with the lien filing.
      - `miscellaneous_info` string, 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_county` string, nullable — The county where the lien is being filed. This is typically the county where the debtor's property or collateral is located.
      - `assigned_business_debtor` V1LienFilingAssignedBusinessDebtorPartyResponse — Represents the response structure for an assigned business debtor party in a lien filing. This model includes details about the business entity acting as a debtor, such as its unique identifier, organizational information, and mailing address. It also incorporates additional response-specific fields like the party's ID.
        - `id` string, uuid — The unique identifier assigned to the lien filing party.
        - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
        - `city` string, nullable — The city of the lien filing party's mailing address.
        - `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'
        - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
        - `organization_name` string, nullable — The name of the organization involved in the lien filing.
        - `organization_type` 'SOLE_PROPRIETORSHIP' | 'GENERAL_PARTNERSHIP' | 'LLC' | 'LLP' | 'LLLP' | 'LP' | 'C_CORPORATION' | 'S_CORPORATION' | 'B_CORPORATION' | 'NONPROFIT' | 'COOPERATIVE' | 'TRUST' | 'PROFESSIONAL_ASSOCIATION' | 'PROFESSIONAL_CORPORATION' | 'TRADE_NAME' | 'BANK' | 'CREDIT_UNION' | 'INSURANCE' | 'OTHER'
        - `type` 'ORGANIZATION', required — Specifies the party type as 'Organization' for the context of this lien filing, indicating that the party is an organization or entity rather than a person.
        - `capacity` 'ESTATE' | 'TRUST' | 'TRUSTEE' | 'NONE_OF_THE_ABOVE' — Defines the various capacities a debtor may assume in the context of a lien, aiding in the comprehension of their legal standing and obligations concerning the lien.
        - `business_id` string, uuid — A unique identifier assigned to the business entity (debtor) involved in the lien filing process.
        - `role` 'Debtor', required — Indicates the role of the party as 'Debtor', signifying their interest is protected by the lien.
      - `assigned_debtor` union — The debtor associated with the business against which the lien is filed. This debtor information is pre-filled based on the business details and cannot be modified (hence not appearing in POST and PUT requests).
        - V1LienFilingAssignedBusinessDebtorPartyResponse — Represents the response structure for an assigned business debtor party in a lien filing. This model includes details about the business entity acting as a debtor, such as its unique identifier, organizational information, and mailing address. It also incorporates additional response-specific fields like the party's ID.
          - `id` string, uuid — The unique identifier assigned to the lien filing party.
          - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
          - `city` string, nullable — The city of the lien filing party's mailing address.
          - `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'
          - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
          - `organization_name` string, nullable — The name of the organization involved in the lien filing.
          - `organization_type` 'SOLE_PROPRIETORSHIP' | 'GENERAL_PARTNERSHIP' | 'LLC' | 'LLP' | 'LLLP' | 'LP' | 'C_CORPORATION' | 'S_CORPORATION' | 'B_CORPORATION' | 'NONPROFIT' | 'COOPERATIVE' | 'TRUST' | 'PROFESSIONAL_ASSOCIATION' | 'PROFESSIONAL_CORPORATION' | 'TRADE_NAME' | 'BANK' | 'CREDIT_UNION' | 'INSURANCE' | 'OTHER'
          - `type` 'ORGANIZATION', required — Specifies the party type as 'Organization' for the context of this lien filing, indicating that the party is an organization or entity rather than a person.
          - `capacity` 'ESTATE' | 'TRUST' | 'TRUSTEE' | 'NONE_OF_THE_ABOVE' — Defines the various capacities a debtor may assume in the context of a lien, aiding in the comprehension of their legal standing and obligations concerning the lien.
          - `business_id` string, uuid — A unique identifier assigned to the business entity (debtor) involved in the lien filing process.
          - `role` 'Debtor', required — Indicates the role of the party as 'Debtor', signifying their interest is protected by the lien.
        - V1LienFilingAssignedPersonDebtorPartyResponse — Represents the response structure for an assigned person debtor party in a lien filing. This model includes details about the person acting as a debtor, such as its unique identifier, organizational information, and mailing address. It also incorporates additional response-specific fields like the party's ID.
          - `id` string, uuid — The unique identifier assigned to the lien filing party.
          - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
          - `city` string, nullable — The city of the lien filing party's mailing address.
          - `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'
          - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
          - `suffix` string, nullable — The suffix of the individual involved in the lien filing, if applicable.
          - `last_name` string, nullable — The last name of the individual involved in the lien filing, if applicable.
          - `first_name` string, nullable — The first name of the individual involved in the lien filing, if applicable.
          - `middle_name` string, nullable — The middle name of the individual involved in the lien filing, if applicable.
          - `type` 'INDIVIDUAL', required — Specifies the party type as 'Individual' for the context of this lien filing, indicating that the party is a person rather than an organization or entity.
          - `capacity` 'ESTATE' | 'TRUST' | 'TRUSTEE' | 'NONE_OF_THE_ABOVE' — Defines the various capacities a debtor may assume in the context of a lien, aiding in the comprehension of their legal standing and obligations concerning the lien.
          - `person_id` string, uuid — A unique identifier assigned to the individual (debtor) involved in the lien filing process.
          - `role` 'Debtor', required — Indicates the role of the party as 'Debtor', signifying their interest is protected by the lien.
      - `debtors` union[], nullable — An enumeration of debtors implicated in the lien filing process. It is imperative to omit the debtor correlated with the business profile against which the lien is being filed. Such a debtor is automatically deduced and pre-populated based on the business_id present in the URL.
        - union
          - V1LienFilingOrganizationDebtorPartyResponse — Represents the response structure for an organization acting as a debtor in a lien filing. This model encapsulates detailed information about an organizational debtor, including its identification, contact details, and specific attributes relevant to its role in the lien. It is designed to provide a comprehensive view of the debtor's information as returned by the API in response to lien-related queries or operations.
            - `id` string, uuid — The unique identifier assigned to the lien filing party.
            - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
            - `city` string, nullable — The city of the lien filing party's mailing address.
            - `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'
            - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
            - `capacity` 'ESTATE' | 'TRUST' | 'TRUSTEE' | 'NONE_OF_THE_ABOVE' — Defines the various capacities a debtor may assume in the context of a lien, aiding in the comprehension of their legal standing and obligations concerning the lien.
            - `organization_name` string, nullable — The name of the organization involved in the lien filing.
            - `organization_type` 'SOLE_PROPRIETORSHIP' | 'GENERAL_PARTNERSHIP' | 'LLC' | 'LLP' | 'LLLP' | 'LP' | 'C_CORPORATION' | 'S_CORPORATION' | 'B_CORPORATION' | 'NONPROFIT' | 'COOPERATIVE' | 'TRUST' | 'PROFESSIONAL_ASSOCIATION' | 'PROFESSIONAL_CORPORATION' | 'TRADE_NAME' | 'BANK' | 'CREDIT_UNION' | 'INSURANCE' | 'OTHER'
            - `type` 'ORGANIZATION', required — Specifies the party type as 'Organization' for the context of this lien filing, indicating that the party is an organization or entity rather than a person.
            - `role` 'Debtor', required — Indicates the role of the party as 'Debtor', signifying their interest is protected by the lien.
          - V1LienFilingIndividualDebtorPartyResponse — Represents the response structure for an individual debtor party in a lien filing. This model encapsulates detailed information about an individual acting as a debtor, including their identification, contact details, and specific attributes relevant to their role in the lien. It is designed to provide a comprehensive view of the individual debtor's information as returned by the API in response to lien-related queries or operations.
            - `id` string, uuid — The unique identifier assigned to the lien filing party.
            - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
            - `city` string, nullable — The city of the lien filing party's mailing address.
            - `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'
            - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
            - `capacity` 'ESTATE' | 'TRUST' | 'TRUSTEE' | 'NONE_OF_THE_ABOVE' — Defines the various capacities a debtor may assume in the context of a lien, aiding in the comprehension of their legal standing and obligations concerning the lien.
            - `suffix` string, nullable — The suffix of the individual involved in the lien filing, if applicable.
            - `last_name` string, nullable — The last name of the individual involved in the lien filing, if applicable.
            - `first_name` string, nullable — The first name of the individual involved in the lien filing, if applicable.
            - `middle_name` string, nullable — The middle name of the individual involved in the lien filing, if applicable.
            - `type` 'INDIVIDUAL', required — Specifies the party type as 'Individual' for the context of this lien filing, indicating that the party is a person rather than an organization or entity.
            - `role` 'Debtor', required — Indicates the role of the party as 'Debtor', signifying their interest is protected by the lien.
      - `secured_parties` union[], nullable — A list of secured parties involved in the lien filing.
        - union
          - V1LienFilingOrganizationSecuredPartyResponse — Represents the response structure for an organization acting as a secured party in a lien filing. This model encapsulates detailed information about an organizational secured party, including their identification, contact details, and specific attributes relevant to their role in the lien. It is designed to provide a comprehensive view of the secured party's information as returned by the API in response to lien-related queries or operations.
            - `id` string, uuid — The unique identifier assigned to the lien filing party.
            - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
            - `city` string, nullable — The city of the lien filing party's mailing address.
            - `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'
            - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
            - `masked` boolean, nullable — A flag to indicate if the secured party should be masked when filing a lien.
            - `is_assignor` boolean, nullable — Whether the secured party is the assignor of the lien.
            - `organization_name` string, nullable — The name of the organization involved in the lien filing.
            - `organization_type` 'SOLE_PROPRIETORSHIP' | 'GENERAL_PARTNERSHIP' | 'LLC' | 'LLP' | 'LLLP' | 'LP' | 'C_CORPORATION' | 'S_CORPORATION' | 'B_CORPORATION' | 'NONPROFIT' | 'COOPERATIVE' | 'TRUST' | 'PROFESSIONAL_ASSOCIATION' | 'PROFESSIONAL_CORPORATION' | 'TRADE_NAME' | 'BANK' | 'CREDIT_UNION' | 'INSURANCE' | 'OTHER'
            - `type` 'ORGANIZATION', required — Specifies the party type as 'Organization' for the context of this lien filing, indicating that the party is an organization or entity rather than a person.
            - `role` 'Secured Party', required — Indicates the role of the party as 'Secured', signifying their interest is protected by the lien.
          - V1LienFilingIndividualSecuredPartyResponse — Represents the response structure for an individual secured party in a lien filing. This model encapsulates detailed information about an individual acting as a secured party, including their identification, contact details, and specific attributes relevant to their role in the lien. It is designed to provide a comprehensive view of the individual secured party's information as returned by the API in response to lien-related queries or operations.
            - `id` string, uuid — The unique identifier assigned to the lien filing party.
            - `mailing_address` string, nullable — The mailing address for the lien filing party, excluding city, state, and postal code.
            - `city` string, nullable — The city of the lien filing party's mailing address.
            - `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'
            - `postal_code` string, nullable — The postal code of the lien filing party's mailing address.
            - `masked` boolean, nullable — A flag to indicate if the secured party should be masked when filing a lien.
            - `is_assignor` boolean, nullable — Whether the secured party is the assignor of the lien.
            - `suffix` string, nullable — The suffix of the individual involved in the lien filing, if applicable.
            - `last_name` string, nullable — The last name of the individual involved in the lien filing, if applicable.
            - `first_name` string, nullable — The first name of the individual involved in the lien filing, if applicable.
            - `middle_name` string, nullable — The middle name of the individual involved in the lien filing, if applicable.
            - `type` 'INDIVIDUAL', required — Specifies the party type as 'Individual' for the context of this lien filing, indicating that the party is a person rather than an organization or entity.
            - `role` 'Secured Party', required — Indicates the role of the party as 'Secured', signifying their interest is protected by the lien.
      - `collateral_statements` union — This field allows for collateral statements to be provided either as plain text or as one or more document attachments, offering flexibility in how detailed information or evidence related to the lien's collateral is presented.
        - V1LienFilingCollateralStatementText — This structure represents the schema for a collateral statement in the form of text provided for a lien filing submission.
          - `collateral_statement_designation` 'NONE' | 'TRUST' | 'PERSONAL_REPRESENTATIVE' — Enumeration of possible designations for a lien collateral statement.
          - `text` string, nullable — A plain text description of the collateral.
          - `type` 'TEXT', required — When using this type, the structure represents the schema for a collateral statement in the form of text provided for a lien filing submission. Setting the `"type":"TEXT"` will remove all previously uploaded attachments for this lien filing submission.
        - V1LienFilingCollateralStatementAttachmentsResponse — This model represents a collateral statement for a lien filing that includes one or more attachments (PDF documents), to provide additional details or evidence related to the collateral. Each attachment is identified by a unique ID and has an associated filename.
          - `collateral_statement_designation` 'NONE' | 'TRUST' | 'PERSONAL_REPRESENTATIVE' — Enumeration of possible designations for a lien collateral statement.
          - `attachments` V1LienFilingAttachment[] — A list of PDF filenames as attachments.
            - `id` string, uuid, required — The unique identifier of the lien filing attachment.
            - `document_filename` string, required — The filename of the document associated with this lien filing attachment.
          - `type` 'ATTACHMENTS', required — When using this type this structure represents a collateral statement for a lien filing that includes one or more attachments (PDF documents), to provide additional details or evidence related to the collateral. Each attachment is identified by a unique ID and has an associated filename.
      - `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_amount` string, nullable — The principal indebted amount in the lien filing submission.
      - `documentary_tax_stamp_required` boolean, 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.
      - `id` string, 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_number` string, 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_date` string, date, nullable — The date when the lien filing was submitted to the jurisdiction.
      - `lapse_date` string, date, nullable — The date when the lien will lapse. Assigned when the lien filing is submitted to the jurisdiction.
      - `has_downloadable_document` boolean — 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.

## Other responses

- `404` — The lien filing submission not found.
- `422` — Validation Error

---

[API](https://skmtc.net/baselayer/apis/baselayer-api-service.md) · [All operations](https://skmtc.net/baselayer/apis/baselayer-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baselayer/baselayer-api-service/versions/0cc89938bc26/schema)
