Lead Qualification API – Score & Filter B2B Leads by Domain
What it does: Qualify a B2B company using only a domain (example: stripe.com). Returns: Decision: qualified / maybe / disqualified Score: 0–100 Reasons: explainable scoring + decision logic Signals (40+): enrichment fields for segmentation + CRM Signals include: Company size estimate + confidence Industry classification Tech stack detection (50+ technologies) Social profiles (LinkedIn, Twitter,…
Lead Qualification API – Score & Filter B2B Leads by Domain endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST |
QualifyLead /v1/qualify-lead |
Analyzes a company domain to determine if it's a qualified lead. This endpoint performs real-time analysis of a company's website to collect signals (pricing pages, security… |
| GET |
ListWebhooks /v1/webhooks |
Returns all webhook configurations registered for your API key. Use this endpoint to view all active and inactive webhooks. The response includes webhook IDs, URLs, descriptions,… |
| POST |
QualifyBatch /v1/qualify-batch |
Processes multiple domains in a single request for efficient bulk qualification. **Processing Modes:** - **Synchronous**: For small batches (≤25 domains by default), results are… |
| DELETE |
DeleteWebhook /v1/webhooks/{id} |
Permanently removes a webhook configuration. Once deleted, the webhook will no longer receive event notifications. Delivery history is preserved and can still be viewed, but no… |
| GET |
GetLeadHistory /v1/lead/{domain}/history |
Retrieves the historical qualification results for a domain, showing how scores and decisions have changed over time. **Use Cases:** - Track how a lead's qualification status has… |
| GET |
Version /v1/version |
Returns the current version of the API and build information. **Response includes:** - `version`: Semantic version of the API (e.g., 1.0.1) - `buildDate`: ISO 8601 timestamp of… |
| GET |
GetBatchJobStatus /v1/batch/{jobId} |
Retrieves the status and results of an asynchronous batch qualification job. Use this endpoint to check the progress of a batch job created via POST /v1/qualify-batch when the… |
| GET |
Health /v1/health |
Returns the health status of the API and its dependencies. This endpoint performs connectivity checks to: - **Database**: Verifies PostgreSQL connection - **Redis**: Verifies… |
| GET |
GetLeadDiff /v1/lead/{domain}/diff |
Compares two historical qualification results for a domain to show what changed between them. **Use Cases:** - Understand why a lead's score changed between qualifications -… |
| GET |
GetLead /v1/lead/{domain} |
Retrieves the most recent qualification data for a specific domain from the database. This endpoint returns the latest stored qualification result, including: - Latest score and… |
| GET |
Usage /v1/usage |
Returns current usage statistics for your API key, including request counts and cache performance. **Response includes:** - `requestsInCurrentWindow`: Number of requests made in… |
| GET |
GetWebhookDeliveries /v1/webhooks/{id}/deliveries |
Retrieves the delivery history for a specific webhook, showing all delivery attempts and their status. **Delivery Statuses:** - `pending`: Delivery is queued or being retried -… |
| POST |
CreateWebhook /v1/webhooks |
Creates a webhook configuration that will receive HTTP POST requests when certain events occur. **Webhook Events:** - `enrichment.ready`: Triggered when background enrichment… |