v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

Lien Search

Get All Lien Searches

This endpoint returns all lien searches.

get/lien_searches

Query parameters

limitinteger

The maximum number of lien searches to return.

offsetinteger

The number of lien searches to skip before starting to return the lien searches.

type'Business' | 'Person' | 'BusinessSearch'

Discriminator for bodies of POST /lien_searches and POST /docket_searches requests. Names a business record, a person record, or a business search

The type of lien searches to return.

Response

Successful 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_statesStateAbbreviation[] 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.

person_idstring uuid nullable

The identifier of the person associated with these lien filings.

business_idstring uuid nullable

The identifier of the business 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.",
    "last_updated_at": "2024-06-01",
    "searched_states": [
      "CA",
      "GA"
    ],
    "person_id": "f87e0009-5d0b-4d6c-934d-3c3cdaa80b6c",
    "business_id": "85f91a95-9dfb-4692-a3cf-7e5b24a80254",
    "business_search_id": "fabc43a5-9ffa-445b-9659-70970613c823"
  }
]