Baselayer Webhooks

generated: '2026-10-14'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.baselayer.com/docs/webhooks-at-baselayer.md
sources:
- https://docs.baselayer.com/docs/webhooks-at-baselayer.md
- https://docs.baselayer.com/docs/webhook-guide-businesssearchupdated.md
- https://docs.baselayer.com/api-reference/webhook-management/create-webhook-endpoint.md
- https://docs.baselayer.com/api-reference/webhook-management/get-webhook-endpoint.md
description: Baselayer webhooks deliver real‑time notifications for asynchronous API operations.
events:
- event: BusinessSearch.submitted
  description: Request received and queued for processing.
- event: BusinessSearch.completed
  description: Processing finished successfully and the full verification data is included.
- event: BusinessSearch.failed
  description: Processing failed (insufficient data, invalid input, etc.).
- event: BusinessSearch.updated
  description: Initial results have been updated with additional data.
- event: LiensSearch.completed
  description: Lien search processing finished and lien data is included.
delivery:
  signature: Each webhook includes a signature that can be verified with the signing secret shown when the endpoint is created (e.g., `whsec_C2FVsBQIhrscChlQIMV+b5sSYspob7oD`).
  retries: 'If the endpoint does not return a 2xx status, Baselayer retries with exponential backoff over 5 attempts: 5 seconds, 5 minutes, 30 minutes,
    2 hours, and a final retry after 5 hours (≈8 hour total window).'
docs: https://docs.baselayer.com/docs/webhooks-at-baselayer.md
note: 3 extracted row(s) were dropped because their quote was not on the page.