/leads/verification/status/{campaign_id} Authentication
Send your organization API key as a Bearer credential.
Authorization: Bearer YOUR_API_KEY Path parameters
campaign_id string required Campaign UUID
550e8400-e29b-41d4-a716-446655440000 Response
application/json Verification status retrieved successfully
status string required Human-readable verification job state
Allowed values: not_running, in_progress, completed
in_progress message string required Human-readable explanation of the current state
Lead verification is in progress percent any required Progress of the running verification job (0-100), or `false` if no job is running for this campaign. When the job completes the verification row is destroyed and subsequent calls return `false` with the final aggregate counts in `data`.
data object required Aggregate counts of leads by verification status. Returned when no verification is running (either never started or just finished).
Show child attributes
data.valid_count number required Leads classified as valid
12 data.unknown_count number required Leads with unknown deliverability
2 data.accept_all_count number required Leads on catch-all domains (accept_all)
4 data.invalid_count number required Leads classified as invalid
5 data.disposable_count number required Leads on disposable email domains
1 Invalid request body (e.g. missing required fields, or invalid field values)
message string[] required List of detailed validation or business error messages
["Name cannot be empty", "Field must be greater than 0"] error string required Short error description
Bad Request statusCode number required HTTP status code of the error
400 This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
message string[] required List of messages explaining why the request was unauthorized
["User is not authorized", "Invalid API key"] error string required Short error description
Unauthorized statusCode number required HTTP status code of the error
401 You have exceeded the rate limit. Please check the rate limit docs for more information.
message string[] required List of messages explaining the rate limiting issue
["Too many requests, please try again later"] error string required Short error description
Too Many Requests statusCode number required HTTP status code of the error
429