Skip to main content
POST
Start Liens Adhoc Search

Authorizations

X-API-Key
string
header
required

Headers

Prefer
string | null

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"

Body

application/json

Start a liens search by name and target states (no business or person record).

name
string
required

The name to search liens for.

Required string length: 1 - 256
search_states
enum<string>[]
required

The states to search for liens in.

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

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."