Skip to main content
WEBHOOK

Body

application/json
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"

__event__
WebhookMetadata · object
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"

Response

Successful Response