Skip to main content
GET
Get All Lien Searches

Authorizations

X-API-Key
string
header
required

Query Parameters

limit
integer
default:10

The maximum number of lien searches to return.

Required range: x >= 1
offset
integer
default:0

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

Required range: x >= 0
type
enum<string>

The type of lien searches to return.

Available options:
Business,
Person,
BusinessSearch
Examples:

"Business"

"Person"

"BusinessSearch"

Response

Successful Response

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"