Skip to main content
GET
Get Liens

Authorizations

X-API-Key
string
header
required

Path Parameters

liens_search_request_id
string<uuid>
required

The unique identifier of the liens search request.

Example:

"49bba8a2-458b-4ea8-afd6-10ee452083bc"

Response

Response

Represents the response from a liens search request. This includes the unique identifier of the request, the current state of the request, and a list of lien filings associated with the request.

id
string<uuid>
required

The identifier of this liens search response.

search_entities
AdditionalLiensSearchEntityResponse (v1) · object[]
required

A list of entities searched in the liens search.

state
enum<string>
required

The current state of the liens search request.

Available options:
PENDING,
EXECUTING,
COMPLETED,
FAILED,
CANCELLED
filings
LienFilingResponse (v1) · object[]
required

A list of lien filings associated with the search request.

last_updated_at
string<date>
required

The date the lien search result was last updated.

Example:

"2024-06-01"

error
string | null

Any errors that occurred during the liens search request.

Example:

"TimeoutError: The Liens Search could not be completed."

searched_states
enum<string>[] | null

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.

Available options:
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
Example:
business_id
string<uuid> | null

The identifier of the business associated with these lien filings.

Example:

"bc145d0c-aea1-4572-844a-2d11ca1f85c0"

person_id
string<uuid> | null

The identifier of the person associated with these lien filings.

Example:

"9cb64976-4cc4-4f52-8171-ce8744d52333"

business_search_id
string<uuid> | null

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

Example:

"0b8d7416-e62c-420e-a593-7c86f26b1590"