Verify a list of emails

POST

https://api.plusvibe.ai/api/v1/verify/emails

Verifies up to 100 email addresses that are not leads. Nothing is written to any campaign or lead. Verification runs in the background: this call returns a task_id, and Get email list verification results returns the per-address results, which fill in while the task runs. Typical completion is 15 to 30 seconds.

Rules:

1 to 100 addresses per call. Each must be a valid email address. Duplicates inside one call are verified once.

The organization must have enough credits for the whole batch (addresses x credit_per_verification, see Get email verification credits), otherwise the call is rejected with 400 and nothing is queued. Credits are then charged per address that gets a result; addresses that fail with a vendor error are not charged.

At most 5 of these tasks may be QUEUED or RUNNING per organization at a time. Stop one with Stop email verification task or wait.

Results are kept for 30 days.

To verify the leads of a campaign instead, use Queue email verification.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/json

Examples

Responses

🟢200OK

application/json

Task queued.

Bodyapplication/json

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.plusvibe.ai/api/v1/verify/emails' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "workspace_id": "65099a0dd96fae8ab61130c0",
    "emails": [
        "jane.doe@example.com",
        "john@example.org"
    ],
    "label": "october-signups.csv"
}'

Response Example

200 - Success Example

{
    "status": "success",
    "task_id": "6719f1a2b3c4d5e6f7a8b9c0",
    "email_count": 2,
    "credits_remaining": 2480.5
}

Modified at 2026-10-23 13:07:12

Stop email verification task

Get email verification credits