1. Email Verification
Plusvibe.ai API Documentation
  • Getting Started
    • Getting Started
    • Webhooks - Overview
    • Webhooks - Payload - Email Replies
    • Webhooks - Payload - Lead Marked As Label
    • Webhooks - Payload - Campaign Emails Sent
    • Webhooks - Payload - Bounced Email
    • Webhooks - Payload - Unibox Email Sent
    • Webhooks - Payload - System Alert
    • Workspace Deep Link Parameter
  • User API Endpoints
    • Workspace
      • Get workspaces
      • Add a new workspace
      • Copy workspace settings
      • Invite a user to a workspace
    • Campaign
      • Create a new campaign
      • Create a new subsequence
      • List all campaigns
      • Get campaign name
      • Get campaign status
      • Get campaign email accounts
      • Get campaign emails
      • Get campaign variation stats
      • Set campaign name
      • Activate campaign
      • Pause campaign
      • Update Campaign
      • Delete or archive a campaign
      • Duplicate campaign
      • Bulk Assign/Remove Tags from Campaigns
    • Lead
      • Add leads to a campaign
      • Add leads to a subsequence campaign
      • Get or search for lead
      • Delete leads from a campaign
      • Lead Variable/Label Update or Add
      • Fetch workspace leads
      • Update the status of a lead
      • Get lead counts by status
    • Email Account
      • List all email accounts in the workspace
      • Get email account status
      • Check account vitals
      • Enable Email account warmup
      • Pause Email account warmup
      • Delete Email account
      • Get Warmup Stats (Per Mailbox)
      • Bulk Add SMTP Accounts
      • Bulk Update Email Accounts
      • Bulk Update Email Account Warmup Status
      • Bulk Assign/Remove Tags from Email Accounts
      • Bulk reconnect email accounts
      • Get workspace email stats for a date range
      • Move Email Accounts to Another Workspace
      • Get email account stats for a date range (per mailbox)
      • Get Warmup Stats (Workspace-Level)
      • Get account recovery details
    • Analytics
      • Get campaign summary
      • Get campaign stats
      • Get workspaces summary
      • Get all campaigns statistics
      • Get workspaces performance
    • Unibox
      • Get email threads (conversations)
      • Get emails
      • Get emails in Others folder
      • Get count of unread emails
      • Reply to an email
      • Forward an existing email
      • Compose New Email
      • Mark Email Read
      • Send to any address
      • Save Email as Draft
      • Delete an Entire Email Thread
      • Delete a Single Email Message
    • Blocklist
      • Get entries in the blocklist
      • Adds entries to the blocklist
      • Delete entries in the blocklist
    • Webhook
      • Add a new webhook
      • List webhooks
      • Delete webhook(s)
    • Tags
      • List Tags
      • Create a New Tag
      • Update an Existing Tag
      • Delete Multiple Tags
    • Client Access
      • Create client
      • Edit client
      • Update client status
      • Delete client
      • List clients
    • Email Placement Test
      • Child (Test Run) Test
        • List child (Test Run) tests
        • Get child test details
      • Results & Analytics
        • Get test summary
        • Get detailed test statistics
        • Get test result for a sender account
      • Parent Test (Recurring & One-off)
        • Create a new parent test
        • Update a parent test
        • List all parent tests
        • Get parent test details
        • Delete parent test(s)
        • Duplicate a parent test
      • Get recipient providers
    • Workspace Additional Fields
      • List Additional Fields
      • Create Additional Field
      • Update Additional Field Default Value
      • Delete Additional Field
    • DFY
      • Search Domain Availability
      • List DFY Subscriptions
      • Generate Sender Identities (MS Enterprise)
      • Place a DFY Order
      • Cancel a DFY Subscription
    • Email Account Automation
      • List automation rules
      • Create automation rule
      • Update automation rule
      • Delete automation rule
      • Get automation rule
      • Enable / disable automation rule
      • Duplicate automation rule
    • Workspace Settings
      • Get Workspace Settings
      • Update Workspace Settings
      • List Lead Labels
      • Add Custom Lead Label
      • Delete Custom Lead Labels
    • Email Verification
      • Queue email verification
        POST
      • Get email verification task
        GET
      • Stop email verification task
        POST
      • Verify a list of emails
        POST
      • Get email verification credits
        GET
      • Get email list verification results
        GET
      • List email verification tasks
        GET
    • Schemas
      • ScheduleV2
      • Campaign
      • EmailAccountId
      • WarmupStatus
      • BulkUpdateWarmupRequest
      • TagAction
      • BulkTagAssignmentRequest
      • ObjectId
      • HexColor
      • CreateTagRequest
      • UpdateTagRequest
      • DeleteTagsRequest
      • DeleteCampaignRequest
      • BulkReconnectRequest
      • SuccessResponse
      • ErrorResponse
      • ClientWorkspacePermission
      • CreateClientRequest
      • CreateClientResponse
      • UpdateClientRequest
      • ClientListItem
      • PatchClientStatusRequest
      • GenericSuccessResponse
      • ParentTest
      • ParentTestDetail
      • ChildTest
      • ChildTestDetail
      • VariationStepStats
      • VariationStats
      • CopyWorkspaceRequest
      • ResourceType
      • CopyWorkspaceResponse
      • EmailStatsHeader
      • EmailStatsResponse
      • EmailStatsChartPoint
      • ValidationErrorResponse
      • CheckSuccess
      • AuthFailure
  • For Email Infra Provider
    • Email Infra Provider Guide
    • List workspaces
    • List all email accounts in the workspace
    • Check if an email exists in another workspace
    • Initiate Google OAuth login flow
    • Initiate Microsoft OAuth login flow
    • Bulk Add SMTP Accounts (via Username and Password)
    • Schemas
      • AuthFailure
      • CheckSuccess
      • ErrorResponse
  1. Email Verification

Queue email verification

POST
https://api.plusvibe.ai/api/v1/verify/queue
Verifies the email addresses of a campaign's leads and stores the result on each lead as is_email_verified (VALID, INVALID, RISKY, NOT_CHECKED). Verification runs in the background: this call returns a task_id to poll with Get email verification task. Read the results with Fetch workspace leads (filter is_email_verified) or Get lead.
Which leads are verified - only leads with status NOT_CONTACTED and a non-empty email are ever verified. Within those, mode selects:
modeleads verified
NEW (default)leads that have never been verified
ALLevery lead, including ones already verified (they are verified again and charged again)
SELECTEDexactly the leads in lead_ids (max 5000)
retry_errors: true also includes leads whose previous verification ended in an error (NEW and ALL only). Default false.
Credits - each verified email consumes verification credits from the workspace's organization. credits_remaining in the response is the organization's current verification credit balance; Get email verification credits also returns the price per email. Leads that cannot be verified because credits ran out are left NOT_CHECKED and the task message says so.
One task per campaign - while a verification task is QUEUED or RUNNING for a campaign, a second queue call for the same campaign is rejected. Stop it first with Stop email verification task or wait for it to finish.
To verify leads at upload time instead, pass verify_lead: true to Add leads.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Body Params application/json

Examples

Responses

🟢200OK
application/json
Task queued.
Bodyapplication/json

🟠400Bad Request
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.plusvibe.ai/api/v1/verify/queue' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "workspace_id": "65099a0dd96fae8ab61130c0",
    "campaign_id": "678ed62eeac0980768c2292f"
}'
Response Response Example
200 - Success Example
{
    "status": "success",
    "task_id": "6719f1a2b3c4d5e6f7a8b9c0",
    "credits_remaining": 2480.6
}
Modified at 2026-10-23 13:07:12
Previous
Delete Custom Lead Labels
Next
Get email verification task
Built with