Skip to main content
GET
Get Adhoc Liens

Authorizations

X-API-Key
string
header
required

Path Parameters

liens_search_request_id
string<uuid>
required

The unique identifier of the adhoc liens search request.

Example:

"3fbc6a5b-b22a-4dc8-a91e-71603790e979"

Response

Response

Represents the response from an adhoc 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.

name
string
required

The name used for the ad-hoc 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"

searched_states
enum<string>[]
required

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

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:
error
string | null

Any errors that occurred during the liens search request.

Example:

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