Sign in

v1

latestOpenAPI 3.1.02026-07-241695611.0 MB
Lien Search

Start Liens Search

This endpoint starts a liens search for a given person or business. Exactly one of business_id or person_id must be provided. If person_id is provided, search_states must be provided.

By default, this endpoint executes synchronously and returns the completed result. Send Prefer: respond-async to opt into asynchronous execution, which returns 202 Accepted immediately and delivers results via webhooks or polling.

post/lien_searches

Headers

Preferstring nullable

Request execution preference (RFC 7240). Use respond-async for asynchronous execution, wait=N to specify a synchronous timeout hint in seconds, or priority=low to route the task to the low-priority queue.

Example:respond-async

Request execution preference (RFC 7240). Use respond-async for asynchronous execution, wait=N to specify a synchronous timeout hint in seconds, or priority=low to route the task to the low-priority queue.

Request body

OR
OR

Example request

{
  "additional_search_entities": [
    {
      "name": "John Doe",
      "search_states": [
        "CA"
      ],
      "type": "Person"
    }
  ]
}

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