v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

Webhook Events

LiensSearch.completed

Emitted when a Liens search for a Business has completed and results are available.

postWebhookLiensSearch.completed

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.

business_idstring uuid nullable

The identifier of the business associated with these lien filings.

person_idstring uuid nullable

The identifier of the person 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.",
  "filings": [
    {
      "filing_number": "P98172",
      "filing_type": "Lien for Loan Default",
      "filing_date": "2023-09-18",
      "lapse_date": "2023-04-15",
      "status": "Under Appeal",
      "number_of_pages": 14,
      "document_filename": "docket_47182.pdf",
      "parties": [
        {
          "name": "Louis Schneider",
          "address": {
            "street": "913 Hendrix Gardens Suite 492",
            "city": "Jasonfurt",
            "zip": "19773",
            "latitude": 38.03012,
            "longitude": 78.47665
          },
          "type": "individual"
        }
      ],
      "amendments": [
        {
          "filing_number": "H76162",
          "filing_type": "Notarized Letter",
          "filing_date": "2023-11-27",
          "number_of_pages": 4
        }
      ],
      "collateral_statements": [
        {
          "text": "2022 Blue Honda Civic"
        }
      ]
    }
  ],
  "last_updated_at": "2024-06-01",
  "searched_states": [
    "FL",
    "CA"
  ],
  "business_id": "88b09bdc-76ce-47e3-99d5-7396e7b5997d",
  "person_id": "71e94341-f34d-45af-bc64-68ef75d457d9",
  "business_search_id": "c2b26348-8006-4dab-a988-4403ea957307"
}

Response

Successful Response

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