> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baselayer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Import Lien Filing Submission

> Imports a lien that already exists in the public record, so an
organization can track a filing it did not file through Baselayer
alongside the ones it did.

The lien is identified by the state and filing number the filing
office assigned it. An amendment's filing number is accepted too and
resolves to the initial financing statement it amends, because that
is the filing the lien itself is identified by. Only consensual UCC
filings can be imported: statutory, judicial and tax liens are
imposed on a debtor rather than granted by one.

The filing number is matched against the spellings the filing is
known to be ingested under (leading zeros, spacing), so the record
returned carries the public record's canonical filing number, which
may differ from the one posted.

Nothing is filed and nothing is copied: the imported record links to
the public filing, so its status, parties and amendment history are
always the ones the jurisdiction currently reports. Imported filings
cannot be updated, submitted, cancelled or amended — delete the
import to give up the claim.

Importing the same lien twice is not an error: the existing record is
returned with a `200 OK` instead of a `201 Created`. A lien the
organization already filed through Baselayer is a `409 Conflict`
instead — it is the same lien, and a second record would only drift
apart from the first.

Not available to sandbox applications: an import claims a filing
that already exists in the public record, so there is nothing to
simulate.



## OpenAPI

````yaml /api-reference/openapi.json post /lien_submissions/import
openapi: 3.1.0
info:
  title: baselayer-api-service
  version: 0.1.0
servers:
  - url: https://api.baselayer.com/
security: []
paths:
  /lien_submissions/import:
    post:
      tags:
        - Lien Filing
      summary: Import Lien Filing Submission
      description: |-
        Imports a lien that already exists in the public record, so an
        organization can track a filing it did not file through Baselayer
        alongside the ones it did.

        The lien is identified by the state and filing number the filing
        office assigned it. An amendment's filing number is accepted too and
        resolves to the initial financing statement it amends, because that
        is the filing the lien itself is identified by. Only consensual UCC
        filings can be imported: statutory, judicial and tax liens are
        imposed on a debtor rather than granted by one.

        The filing number is matched against the spellings the filing is
        known to be ingested under (leading zeros, spacing), so the record
        returned carries the public record's canonical filing number, which
        may differ from the one posted.

        Nothing is filed and nothing is copied: the imported record links to
        the public filing, so its status, parties and amendment history are
        always the ones the jurisdiction currently reports. Imported filings
        cannot be updated, submitted, cancelled or amended — delete the
        import to give up the claim.

        Importing the same lien twice is not an error: the existing record is
        returned with a `200 OK` instead of a `201 Created`. A lien the
        organization already filed through Baselayer is a `409 Conflict`
        instead — it is the same lien, and a second record would only drift
        apart from the first.

        Not available to sandbox applications: an import claims a filing
        that already exists in the public record, so there is nothing to
        simulate.
      operationId: import_lien_filing_submission_lien_submissions_import_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1.LienFilingSubmissionImportRequest'
              title: Lien Filing Import Request
              description: The request object identifying the lien filing to import.
              examples:
                - state: IL
                  filing_number: P98172
                  filing_name: Acme Inc — 2023 equipment lien
        required: true
      responses:
        '200':
          description: >-
            The organization had already imported this lien filing; the existing
            record is returned.
        '201':
          description: Successfully imported the lien filing.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1.LienFilingSubmissionImportedResponse'
        '402':
          description: >-
            The calling application is a sandbox application, which cannot claim
            filings from the public record, or the organization is locked.
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/APIError'
                    title: PaymentRequiredSandboxApplication
                    description: >-
                      Payment Required. Sandbox applications do not support this
                      request.
                    examples:
                      - code: 500
                        message: >-
                          Payment Required. Sandbox applications do not support
                          this request.
                        metadata: {}
                  - $ref: '#/components/schemas/APIError'
                    title: OrganizationLocked
                    description: >-
                      The organization is locked due to payment issues. Please
                      update your payment information.
                    examples:
                      - code: 3004
                        message: >-
                          The organization is locked due to payment issues.
                          Please update your payment information.
                        metadata: {}
                title: >-
                  Response 402 Import Lien Filing Submission Lien Submissions
                  Import Post
        '404':
          description: >-
            No lien filing with the given state and filing number exists in the
            public record.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
                title: ResourceNotFound
                description: Could not locate the resource for the given URI.
                examples:
                  - code: 1
                    message: Could not locate the resource for the given URI.
                    metadata: {}
        '409':
          description: >-
            The organization already holds this lien as a filing made through
            Baselayer, or as an unverified attestation-based record.
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/APIError'
                    title: LienFilingAlreadyHeld
                    description: >-
                      This lien filing is already held by the organization as a
                      Baselayer filing.
                    examples:
                      - code: 489
                        message: >-
                          This lien filing is already held by the organization
                          as a Baselayer filing.
                        metadata: {}
                  - $ref: '#/components/schemas/APIError'
                    title: LienFilingHeldAsUnverifiedImport
                    description: >-
                      This lien filing is already held by the organization as an
                      unverified, attestation-based record, which carries no
                      link to the public filing. Import cannot claim the public
                      record over it — look the initial filing up instead to see
                      what the public record now says.
                    examples:
                      - code: 491
                        message: >-
                          This lien filing is already held by the organization
                          as an unverified, attestation-based record, which
                          carries no link to the public filing. Import cannot
                          claim the public record over it — look the initial
                          filing up instead to see what the public record now
                          says.
                        metadata: {}
                title: >-
                  Response 409 Import Lien Filing Submission Lien Submissions
                  Import Post
        '422':
          description: The public record filing is not a consensual UCC filing.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
                title: CannotImportNonConsensualLienFiling
                description: >-
                  Only consensual lien filings can be imported. Statutory,
                  judicial and tax liens are imposed on a debtor rather than
                  granted by one, so they are not tracked as UCC financing
                  statements.
                examples:
                  - code: 490
                    message: >-
                      Only consensual lien filings can be imported. Statutory,
                      judicial and tax liens are imposed on a debtor rather than
                      granted by one, so they are not tracked as UCC financing
                      statements.
                    metadata: {}
      security:
        - APIKeyHeader: []
components:
  schemas:
    v1.LienFilingSubmissionImportRequest:
      properties:
        state:
          $ref: '#/components/schemas/StateAbbreviation'
          title: Jurisdiction State
          description: The state abbreviation of the jurisdiction the lien is filed in.
          examples:
            - IL
        filing_number:
          type: string
          maxLength: 64
          minLength: 1
          title: Lien Filing Number
          description: >-
            The filing number assigned by the filing office. Both the initial
            financing statement and any of its amendments are accepted; an
            amendment resolves to the initial financing statement it amends.
          examples:
            - P98172
        filing_name:
          anyOf:
            - type: string
              maxLength: 128
              title: Filing Name
              description: A custom name for the imported filing (only filer's reference).
              examples:
                - Acme Inc — 2023 equipment lien
            - type: 'null'
              title: No Filing Name provided.
              description: The filing name defaults to the filing number.
          title: Filing Name
      additionalProperties: false
      type: object
      required:
        - state
        - filing_number
      title: LienFilingSubmissionImportRequest (v1)
      description: >-
        Request schema for importing a lien that already exists in the public

        record, identified by the state and filing number of its initial
        financing

        statement.


        Importing does not file anything: it records the organization's claim
        over

        a filing Baselayer already holds in its public corpus, and the filing's

        status, parties and amendment history keep tracking that corpus.
    v1.LienFilingSubmissionImportedResponse:
      properties:
        reference_data:
          anyOf:
            - description: >-
                Reference text that will show up in the UCC form under box 8
                (OPTIONAL FILER REFERENCE DATA).
              examples:
                - Filing for a 1967 Ford Mustang
                - 'Case #12345XYZ'
                - 'Debtor: John Doe'
              maxLength: 128
              title: Reference Data
              type: string
            - description: No reference data is provided for the lien filing.
              title: No Reference Data
              type: 'null'
          title: Reference Data
        submission_filing_name:
          anyOf:
            - description: A custom name for the filing (only filer's reference).
              examples:
                - My Lien Filing
                - Springfield Property Lien
                - 2023 Equipment Lien
              maxLength: 128
              title: Filing Name
              type: string
            - description: >-
                The filing name will be automatically generated based on the
                debtor's name and the type of filing.
              title: No Filing Name provided.
              type: 'null'
          title: Submission Filing Name
        search_to_reflect:
          anyOf:
            - description: >-
                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.
              title: Search to Reflect
              type: boolean
            - description: >-
                When set to false, a search will not be conducted on the debtor
                post-filing to verify that the filing has been properly
                registered by the filing office.
              title: No Search to Reflect
              type: 'null'
          title: Search To Reflect
        email_contact:
          anyOf:
            - description: >-
                This email will receive all correspondence concerning this lien
                filing.
              maxLength: 256
              title: Lien Filing Email Contact
              type: string
            - description: >-
                No email contact has been provided for the lien filing
                submission.
              title: No Email Contact provided.
              type: 'null'
          title: Email Contact
        real_estate_info:
          anyOf:
            - $ref: '#/components/schemas/v1.LienFilingRealEstateInfo'
            - $ref: '#/components/schemas/v1.LienFilingNoRealEstateInfo'
            - description: The real estate information will not be updated.
              title: Real Estate Information Omitted
              type: 'null'
          title: Real Estate Information
          description: >-
            The real estate information associated with the lien filing
            submission.
        miscellaneous_info:
          anyOf:
            - description: >-
                Miscellaneous information associated with the lien filing
                submission.
              maxLength: 256
              title: Miscellaneous Information
              type: string
            - description: >-
                No miscellaneous information has been provided for the lien
                filing submission.
              title: No Miscellaneous Information provided.
              type: 'null'
          title: Miscellaneous Info
        id:
          description: The unique identifier for the lien filing submission.
          format: uuid
          title: Lien Filing Submission ID
          type: string
        filing_status:
          $ref: '#/components/schemas/LienFilingSubmissionStatus'
          title: Lien Filing Submission Status
          description: The current state of the lien filing submission.
        filing_number:
          anyOf:
            - description: >-
                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.
              examples:
                - UCC1-1234567890
              maxLength: 128
              title: Lien Filing Number
              type: string
            - description: >-
                This field is set to `null` until the lien filing has been
                officially recorded.
              title: No Filing Number assigned yet.
              type: 'null'
          title: Filing Number
        filing_date:
          anyOf:
            - description: The date when the lien filing was submitted to the jurisdiction.
              examples:
                - '2023-01-01'
              format: date
              title: Filing Date
              type: string
            - description: >-
                No filing date has been assigned to the lien filing as the lien
                filing has not been submitted to the jurisdiction yet.
              title: No Filing Date assigned yet.
              type: 'null'
          title: Filing Date
        lapse_date:
          anyOf:
            - description: >-
                The date when the lien will lapse. Assigned when the lien filing
                is submitted to the jurisdiction.
              examples:
                - '2024-04-20'
              format: date
              title: Lapse Date
              type: string
            - description: >-
                No lapse date has been assigned to the lien filing as the lien
                filing has not been submitted to the jurisdiction yet.
              title: No Lapse Date assigned yet.
              type: 'null'
          title: Lapse Date
        has_downloadable_document:
          default: false
          description: >-
            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.
          title: Has Downloadable Document
          type: boolean
        origin:
          $ref: '#/components/schemas/LienFilingOrigin'
          title: Lien Filing Origin
          description: >-
            How the organization came to own this lien filing: it was filed
            through Baselayer, or imported by the organization from a filing
            that already exists in the public record.
          default: filed_via_baselayer
        filing_type:
          const: UCC1
          default: UCC1
          description: >-
            Initial financing statement, which is the filing an imported lien is
            identified by.
          title: Filing Type
          type: string
        state:
          $ref: '#/components/schemas/StateAbbreviation'
          title: Jurisdiction State
          description: The state abbreviation of the jurisdiction the lien is filed in.
          examples:
            - IL
        status:
          $ref: '#/components/schemas/LienFilingStatus'
          title: Lien Status
          description: >-
            The lien's standing in the public record, derived from its amendment
            history and lapse date (UCC §9-515).
          examples:
            - Active
        imported_unverified:
          default: false
          description: >-
            Whether this filing is held from the details the caller supplied
            rather than verified against the public record. Its status, dates
            and parties are the caller's own claim, estimated under UCC §9-515
            where the public record would otherwise answer.
          examples:
            - false
          title: Unverified Import
          type: boolean
        debtors:
          description: The debtors recorded against the lien in the public record.
          items:
            $ref: '#/components/schemas/v1.LienPartyResponse'
          title: Debtors
          type: array
        secured_parties:
          description: The secured parties recorded against the lien in the public record.
          items:
            $ref: '#/components/schemas/v1.LienPartyResponse'
          title: Secured Parties
          type: array
        amendments:
          description: >-
            The continuations, terminations, assignments and other amendments
            recorded against the lien in the public record.
          items:
            $ref: '#/components/schemas/v1.LienAmendmentResponse'
          title: Amendments
          type: array
      additionalProperties: false
      type: object
      required:
        - type
      title: LienFilingSubmissionImportedResponse (v1)
      description: >-
        Represents a lien filing an organization imported from the public
        record.


        Baselayer holds no submission of its own for these filings, so
        everything

        describing the lien — its status, parties and amendment history — is
        derived

        from the public corpus at read time rather than from an editable draft.
    APIError:
      properties:
        code:
          type: integer
          title: Code
        message:
          type: string
          title: Message
        uri:
          anyOf:
            - type: string
            - type: 'null'
          title: Uri
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
      type: object
      required:
        - code
        - message
      title: APIError
      description: >-
        APIError is a Pydantic model for standardizing error responses from the
        API.


        This class is used internally by APIException for JSON serialization.

        Users should typically work with APIException directly in exception
        catalogs.
    StateAbbreviation:
      enum:
        - 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
      title: StateAbbreviation
      type: string
    v1.LienFilingRealEstateInfo:
      description: >-
        This model represents the real estate record in a lien filing
        submission.
      properties:
        type:
          const: FILE_IN_REAL_ESTATE_RECORDS
          default: FILE_IN_REAL_ESTATE_RECORDS
          description: >-
            Indicates that this FINANCING STATEMENT is to be filed [for record]
            (or recorded) in the REAL ESTATE RECORDS.
          title: File In Real Estate Records
          type: string
        covers_timber:
          anyOf:
            - description: >-
                Whether the financing statement filed in the lien filing
                submission covers timber.
              title: Financing Statement Covers Timber
              type: boolean
            - description: Skipping the Timber flag of the financing statement.
              title: Financing Statement Covers Timber Skipped
              type: 'null'
          default: null
          title: Covers Timber
        covers_as_extracted_collateral:
          anyOf:
            - description: >-
                Whether the financing statement filed in the lien filing
                submission covers as-extracted collateral.
              title: Financing Statement Covers As Extracted Collateral
              type: boolean
            - description: >-
                Skipping the As Extracted Collateral flag of the financing
                statement.
              title: Financing Statement Covers As Extracted Collateral Skipped
              type: 'null'
          default: null
          title: Covers As Extracted Collateral
        filed_as_fixture:
          anyOf:
            - description: >-
                Whether the financing statement filed in the lien filing
                submission is filed as a fixture.
              title: Financing Statement Filed As Fixture
              type: boolean
            - description: Skipping the Fixture flag of the financing statement.
              title: Financing Statement Filed As Fixture Skipped
              type: 'null'
          default: null
          title: Filed As Fixture
        real_estate_record_owner:
          anyOf:
            - description: The owner of the real estate record of the lien filing.
              discriminator:
                mapping:
                  INDIVIDUAL:
                    $ref: >-
                      #/components/schemas/v1.LienFilingIndividualRecordOwnerParty
                  ORGANIZATION:
                    $ref: >-
                      #/components/schemas/v1.LienFilingOrganizationRecordOwnerParty
                propertyName: type
              oneOf:
                - $ref: >-
                    #/components/schemas/v1.LienFilingOrganizationRecordOwnerParty
                - $ref: '#/components/schemas/v1.LienFilingIndividualRecordOwnerParty'
              title: Real Estate Record Owner
            - description: Skipping the Real Estate Record Owner field.
              title: Real Estate Record Owner Skipped
              type: 'null'
          title: Real Estate Record Owner
        real_estate_description:
          anyOf:
            - description: A description of the real estate.
              maxLength: 1024
              title: Real Estate Description
              type: string
            - description: Skipping the Real Estate Description field.
              title: Real Estate Description Skipped
              type: 'null'
          default: null
          title: Real Estate Description
      required:
        - type
      title: LienFilingRealEstateInfo (v1)
      type: object
    v1.LienFilingNoRealEstateInfo:
      description: >-
        This model represents the absence of real estate information associated
        with a lien filing.
      properties:
        type:
          const: NO_REAL_ESTATE_INFO
          default: NO_REAL_ESTATE_INFO
          description: >-
            Indicates that no real estate information is associated with the
            lien filing.
          title: Do not file in real estate records
          type: string
      required:
        - type
      title: LienFilingNoRealEstateInfo (v1)
      type: object
    LienFilingSubmissionStatus:
      description: >-
        Enum class delineating the various stages of a lien filing submission's
        lifecycle.
      enum:
        - Draft
        - Requested
        - InReview
        - NeedsAttention
        - Submitted
        - Filed
        - Cancelled
      title: LienFilingSubmissionStatus
      type: string
    LienFilingOrigin:
      enum:
        - filed_via_baselayer
        - imported
      title: LienFilingOrigin
      type: string
    LienFilingStatus:
      description: >-
        Enumeration of possible statuses for a lien filing. A lien filing's
        status

        indicates its current state within its lifecycle and legal
        enforceability.
      enum:
        - Active
        - Inactive
        - Lapsed
        - Released
        - Satisfied
        - Expired
        - Pending
        - Contested
        - Disputed
        - Perfected
        - Unperfected
        - Void
        - Invalid
        - Enforcement
        - Foreclosure
        - Subordinated
        - Avoided
        - Terminated
        - Draft
        - InPreperation
        - Unknown
      title: LienFilingStatus
      type: string
    v1.LienPartyResponse:
      description: >-
        Represents an entity involved in a lien as either a debtor or a secured
        party.

        This model captures common attributes and relationships of these
        parties.
      properties:
        id:
          description: The identifier of this lien filing record.
          format: uuid
          title: Id
          type: string
        role:
          $ref: '#/components/schemas/v1.LienPartyRole'
          description: >-
            Categorizes the party as either a debtor owing the debt or a secured
            party holding the collateral interest.
          examples:
            - Debtor
        name:
          description: >-
            Legal name of the party; crucial for due diligence and legal
            proceedings related to the lien.
          examples:
            - Louis Schneider
          title: Name
          type: string
        address:
          anyOf:
            - $ref: '#/components/schemas/v1.AddressSummaryResponse'
            - type: 'null'
          description: >-
            Address of the party; provides the physical location for legal
            notices or contact purposes.
        mailing_address:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: >-
            Street of the party's address as written on the filing itself, when
            known. It may accompany `address` rather than replace it: `address`
            is the verified address record behind the party when there is one,
            and these components are what the filing says — the only address a
            party with no verified record has.
          examples:
            - 1 Market Street
          title: Mailing Address
        city:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: >-
            City of the party's address as recorded on the filing itself; see
            `mailing_address`.
          examples:
            - San Francisco
          title: City
        state:
          anyOf:
            - $ref: '#/components/schemas/v1.StateAbbreviation'
            - type: 'null'
          default: null
          description: >-
            State of the party's address as recorded on the filing itself; see
            `mailing_address`.
          examples:
            - CA
        postal_code:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: >-
            Postal code of the party's address as recorded on the filing itself;
            see `mailing_address`.
          examples:
            - '94105'
          title: Postal Code
        type:
          description: >-
            The type of lien party, indicating whether the party is an
            individual or an organization.

            A computed property that returns the role of the lien party. 

            Note: This `type` property is planned to be deprecated in favor of
            the `role` field in future versions.
          examples:
            - individual
            - organization
          title: Type
          type: string
      required:
        - id
        - role
        - name
        - address
        - type
      title: LienPartyResponse (v1)
      type: object
    v1.LienAmendmentResponse:
      description: |-
        Represents a change or update to a lien filing, such as a continuation,
        termination, or assignment that affects the lien's validity or terms.
      properties:
        filing_number:
          description: The document filing number.
          examples:
            - H76162
          title: Filing Number
          type: string
        filing_type:
          description: The document filing type.
          examples:
            - Notarized Letter
          title: Filing Type
          type: string
        filing_date:
          description: The date of the lien filing.
          examples:
            - '2023-11-27'
          format: date
          title: Filing Date
          type: string
        number_of_pages:
          description: Number of image pages in the library for this filing number.
          examples:
            - 4
          title: Number Of Pages
          type: integer
      required:
        - filing_number
        - filing_type
        - filing_date
        - number_of_pages
      title: LienAmendmentResponse (v1)
      type: object
    v1.LienFilingIndividualRecordOwnerParty:
      description: Represents an individual record owner party involved in a lien filing.
      properties:
        mailing_address:
          anyOf:
            - description: >-
                The mailing address for the lien filing party, excluding city,
                state, and postal code.
              examples:
                - 123 Main St
                - 456 Elm St Apt 101
                - 789 Pine St NW Suite 500
              maxLength: 128
              title: Mailing Address
              type: string
            - description: No mailing address is provided for the party.
              title: No Mailing Address
              type: 'null'
          default: null
          title: Mailing Address
        city:
          anyOf:
            - description: The city of the lien filing party's mailing address.
              examples:
                - Springfield
                - Metropolis
                - Gotham
              maxLength: 128
              title: City
              type: string
            - description: No city is provided for the party.
              title: No City
              type: 'null'
          default: null
          title: City
        state:
          anyOf:
            - $ref: '#/components/schemas/v1.StateAbbreviation'
              description: >-
                The state abbreviation of the lien filing party's mailing
                address.
              examples:
                - AL
                - CA
                - NY
              title: State
            - description: No state is provided for the party.
              title: No State
              type: 'null'
          default: null
          title: State
        postal_code:
          anyOf:
            - description: The postal code of the lien filing party's mailing address.
              examples:
                - '62701'
                - '90210'
                - '10001'
              maxLength: 16
              title: Postal Code
              type: string
            - description: No postal code is provided for the party.
              title: No Postal Code
              type: 'null'
          default: null
          title: Postal Code
        suffix:
          anyOf:
            - description: >-
                The suffix of the individual involved in the lien filing, if
                applicable.
              examples:
                - Jr.
                - Sr.
                - III
              maxLength: 16
              title: Individual Suffix
              type: string
            - description: No suffix is provided for the individual.
              title: No Suffix
              type: 'null'
          default: null
          title: Suffix
        last_name:
          anyOf:
            - description: >-
                The last name of the individual involved in the lien filing, if
                applicable.
              examples:
                - Doe
                - Smith
                - Johnson
              maxLength: 16
              title: Individual Last Name
              type: string
            - description: No last name is provided for the individual.
              title: No Last Name
              type: 'null'
          default: null
          title: Last Name
        first_name:
          anyOf:
            - description: >-
                The first name of the individual involved in the lien filing, if
                applicable.
              examples:
                - John
                - Jane
                - Alex
              maxLength: 16
              title: Individual First Name
              type: string
            - description: No first name is provided for the individual.
              title: No First Name
              type: 'null'
          default: null
          title: First Name
        middle_name:
          anyOf:
            - description: >-
                The middle name of the individual involved in the lien filing,
                if applicable.
              examples:
                - Anne
                - Michael
                - Luis
              maxLength: 16
              title: Individual Middle Name
              type: string
            - description: No middle name is provided for the individual.
              title: No Middle Name
              type: 'null'
          default: null
          title: Middle Name
        type:
          const: INDIVIDUAL
          description: >-
            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.
          title: Individual Party Type
          type: string
      required:
        - type
      title: LienFilingIndividualRecordOwnerParty (v1)
      type: object
    v1.LienFilingOrganizationRecordOwnerParty:
      description: Represents an organization record owner party involved in a lien filing.
      properties:
        mailing_address:
          anyOf:
            - description: >-
                The mailing address for the lien filing party, excluding city,
                state, and postal code.
              examples:
                - 123 Main St
                - 456 Elm St Apt 101
                - 789 Pine St NW Suite 500
              maxLength: 128
              title: Mailing Address
              type: string
            - description: No mailing address is provided for the party.
              title: No Mailing Address
              type: 'null'
          default: null
          title: Mailing Address
        city:
          anyOf:
            - description: The city of the lien filing party's mailing address.
              examples:
                - Springfield
                - Metropolis
                - Gotham
              maxLength: 128
              title: City
              type: string
            - description: No city is provided for the party.
              title: No City
              type: 'null'
          default: null
          title: City
        state:
          anyOf:
            - $ref: '#/components/schemas/v1.StateAbbreviation'
              description: >-
                The state abbreviation of the lien filing party's mailing
                address.
              examples:
                - AL
                - CA
                - NY
              title: State
            - description: No state is provided for the party.
              title: No State
              type: 'null'
          default: null
          title: State
        postal_code:
          anyOf:
            - description: The postal code of the lien filing party's mailing address.
              examples:
                - '62701'
                - '90210'
                - '10001'
              maxLength: 16
              title: Postal Code
              type: string
            - description: No postal code is provided for the party.
              title: No Postal Code
              type: 'null'
          default: null
          title: Postal Code
        organization_name:
          anyOf:
            - description: The name of the organization involved in the lien filing.
              examples:
                - Acme Inc
                - Globex Corporation
                - Initech LLC
              maxLength: 128
              title: Organization Name
              type: string
            - description: No organization name is provided for the party.
              title: No Organization Name
              type: 'null'
          default: null
          title: Organization Name
        organization_type:
          anyOf:
            - $ref: '#/components/schemas/v1.BusinessStructure'
              description: >-
                The type of organization involved in the lien filing, if
                applicable.
              title: Organization Type
            - description: No organization type is provided for the party.
              title: No Organization Type
              type: 'null'
          default: null
          title: Organization Type
        type:
          const: ORGANIZATION
          description: >-
            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.
          title: Organization Party Type
          type: string
      required:
        - type
      title: LienFilingOrganizationRecordOwnerParty (v1)
      type: object
    v1.LienPartyRole:
      description: |-
        Enum class delineating the role of parties in a lien transaction as
        defined by the UCC.
      enum:
        - Debtor
        - Secured Party
        - Record Owner
      title: LienPartyRole
      type: string
    v1.AddressSummaryResponse:
      description: |-
        Response model for address summary data.

        This model defines the structure for address summary API responses.
      properties:
        id:
          description: Unique identifier for the address.
          format: uuid
          title: Id
          type: string
        street:
          description: Street name of the address.
          examples:
            - 913 Hendrix Gardens Suite 492
          title: Street
          type: string
        city:
          description: City name of the address.
          examples:
            - Jasonfurt
          title: City
          type: string
        state:
          $ref: '#/components/schemas/v1.StateAbbreviation'
          description: State 2 letter abbreviation of the address.
          examples:
            - VA
        zip:
          description: Zip code of the address.
          examples:
            - '19773'
          title: Zip
          type: string
        latitude:
          description: Latitude of the address.
          examples:
            - 38.03012
          title: Latitude
          type: number
        longitude:
          description: Longitude of the address.
          examples:
            - 78.47665
          title: Longitude
          type: number
        rdi:
          anyOf:
            - $ref: '#/components/schemas/v1.AddressRDI'
            - type: 'null'
          default: null
          description: Residential Delivery Indicator of the address.
          examples:
            - Commercial
        deliverable:
          anyOf:
            - type: boolean
            - type: 'null'
          default: null
          description: Indicates whether the address is deliverable.
          examples:
            - false
          title: Deliverable
        cmra:
          anyOf:
            - type: boolean
            - type: 'null'
          default: null
          description: >-
            Indicates whether the address is a Commercial Mail Receiving Agency
            (CMRA).
          examples:
            - false
          title: Cmra
        url:
          anyOf:
            - format: uri
              maxLength: 2083
              minLength: 1
              type: string
            - type: 'null'
          default: null
          description: The URL to the address details.
          title: Url
        delivery_type:
          anyOf:
            - $ref: '#/components/schemas/v1.USPSDeliveryType'
            - type: 'null'
          default: null
          description: The USPS delivery type.
          examples:
            - STREET
            - FIRM
      required:
        - id
        - street
        - city
        - state
        - zip
        - latitude
        - longitude
      title: AddressSummaryResponse (v1)
      type: object
    v1.StateAbbreviation:
      enum:
        - 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
      title: StateAbbreviation
      type: string
    v1.BusinessStructure:
      enum:
        - 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
      title: BusinessStructure
      type: string
    v1.AddressRDI:
      enum:
        - Residential
        - Commercial
      title: AddressRDI
      type: string
    v1.USPSDeliveryType:
      description: |-
        Enum representing the different types of USPS delivery points.
        Used to classify addresses based on how mail is delivered to them.
      enum:
        - FIRM
        - GENERAL_DELIVERY
        - HIGH_RISE
        - POST_OFFICE
        - RURAL_ROUTE
        - STREET
      title: USPSDeliveryType
      type: string
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````