v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

Webhook Events

LiensSearch.failed

Emitted when a Liens search for a Business has failed.

postWebhookLiensSearch.failed

Payload

idstring uuid required

The identifier of this liens search response.

state'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' required

errorstring nullable

Any errors that occurred during the liens search request.

last_updated_atstring date required

The date the lien search result was last updated.

searched_statesStateAbbreviation[] nullable

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.

person_idstring uuid nullable

The identifier of the person associated with these lien filings.

business_idstring uuid nullable

The identifier of the business associated with these lien filings.

business_search_idstring uuid nullable

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

Example payload

{
  "error": "TimeoutError: The Liens Search could not be completed.",
  "last_updated_at": "2024-06-01",
  "searched_states": [
    "CA",
    "GA"
  ],
  "person_id": "f87e0009-5d0b-4d6c-934d-3c3cdaa80b6c",
  "business_id": "85f91a95-9dfb-4692-a3cf-7e5b24a80254",
  "business_search_id": "fabc43a5-9ffa-445b-9659-70970613c823"
}

Response

Successful Response

{"stackTrail":"webhooks:LiensSearch.failed:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}