Sign in

v1

latestOpenAPI 3.1.02026-07-241695611.0 MB
Lien Search

Get Liens

This endpoint retrieves a specific lien search request by its unique identifier. It returns a LiensSearchRequest object that includes the state of the request and a list of lien filings associated with the request.

The lien filings provide detailed information about each lien, including the filing number, type, date, status, and associated business and search request. The model also links to any amendments and the involved parties.

get/lien_searches/{liens_search_request_id}

Path parameters

liens_search_request_idstring uuid required

The unique identifier of the liens search request.

Example:24b9e8e7-9f9d-42d4-8fba-f4c49a550e1b

The unique identifier of the liens search request.

Response

Response

idstring uuid required

The identifier of this liens search response.

state'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' required
errorstring nullable

Any errors that occurred during the liens search request.

last_updated_atstring date required

The date the lien search result was last updated.

searched_statesV1StateAbbreviation[] nullable

Indicates the list of states specified in the liens search request. When states are provided, the search was limited to liens within these specified states, regardless of the business's registered states.

business_idstring uuid nullable

The identifier of the business associated with these lien filings.

person_idstring uuid nullable

The identifier of the person associated with these lien filings.

business_search_idstring uuid nullable

The identifier of the business search associated with these lien filings.

Example response

{
  "error": "TimeoutError: The Liens Search could not be completed.",
  "filings": [
    {
      "filing_number": "P98172",
      "filing_type": "Lien for Loan Default",
      "filing_date": "2023-09-18",
      "lapse_date": "2023-04-15",
      "status": "Under Appeal",
      "number_of_pages": 14,
      "document_filename": "docket_47182.pdf",
      "parties": [
        {
          "name": "Louis Schneider",
          "address": {
            "street": "913 Hendrix Gardens Suite 492",
            "city": "Jasonfurt",
            "zip": "19773",
            "latitude": 38.03012,
            "longitude": 78.47665
          },
          "type": "individual"
        }
      ],
      "amendments": [
        {
          "filing_number": "H76162",
          "filing_type": "Notarized Letter",
          "filing_date": "2023-11-27",
          "number_of_pages": 4
        }
      ],
      "collateral_statements": [
        {
          "text": "2022 Blue Honda Civic"
        }
      ]
    }
  ],
  "last_updated_at": "2024-06-01",
  "searched_states": [
    "FL",
    "CA"
  ],
  "business_id": "88b09bdc-76ce-47e3-99d5-7396e7b5997d",
  "person_id": "71e94341-f34d-45af-bc64-68ef75d457d9",
  "business_search_id": "c2b26348-8006-4dab-a988-4403ea957307"
}