Skip to main content
GET
Get Liens Search Status

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:

"32efbaf2-8037-4218-a368-13d844a6fdf8"

Response

Successful Response

Represents the status of a liens search request. This includes the unique identifier of the request, the current state of the request, and any errors that occurred during the request.

id
string<uuid>
required

The identifier of this liens search response.

state
enum<string>
required

The current state of the liens search request.

Available options:
PENDING,
EXECUTING,
COMPLETED,
FAILED,
CANCELLED
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:
person_id
string<uuid> | null

The identifier of the person associated with these lien filings.

Example:

"f6f56773-54c8-4fb1-a550-bbee60a364e8"

business_id
string<uuid> | null

The identifier of the business associated with these lien filings.

Example:

"9fbd8770-34bb-4798-8c8c-538fcdf23bd3"

business_search_id
string<uuid> | null

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

Example:

"7a9f00b7-2a1a-46fe-88d4-0c172b046151"