Sign in

v1

latestOpenAPI 3.1.02026-07-241695611.0 MB
Lien Search

Start Liens Adhoc Search

Start an ad-hoc liens search using a name and explicit search states.

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/adhoc

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

namestring required

The name to search liens for.

search_statesStateAbbreviation[] required

The states to search for liens in.

Response

Response

idstring uuid required

The identifier of this liens search response.

namestring required

The name used for the ad-hoc liens search.

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[] required

Indicates the list of states specified in the liens search request.

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