Get email verification task

GET

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

Returns the progress of a verification task queued with Queue email verification.

status	meaning
`QUEUED`	waiting for a worker
`RUNNING`	verifying
`COMPLETED`	finished; results are on the leads. `message` is `Done`, or says what cut the run short, e.g. credits ran out
`STOPPED`	stopped with Stop email verification task; leads not reached stay `NOT_CHECKED`
`FAILED`	the task could not run; `message` has the reason

total_rows is the number of leads selected for this run (0 until the task starts). processed_rows is how many of them have a result so far. credits_remaining is the organization's verification credit balance at the time of the call. Poll every few seconds, not in a tight loop.

type is CAMPAIGN (queued with Queue email verification or verify_lead on upload) or LIST (queued with Verify a list of emails); label is the text given when queueing, if any.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

Query Params

Responses

🟢200OK

application/json

Operation completed successfully.

Bodyapplication/json

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.plusvibe.ai/api/v1/verify/get?workspace_id=65099a0dd96fae8ab61130c0&task_id=6719f1a2b3c4d5e6f7a8b9c0' \
--header 'x-api-key: <api-key>'

Response Example

200 - Success Example

{
    "status": "success",
    "data": {
        "task_id": "6719f1a2b3c4d5e6f7a8b9c0",
        "type": "CAMPAIGN",
        "label": "",
        "campaign_id": "678ed62eeac0980768c2292f",
        "status": "RUNNING",
        "mode": "NEW",
        "retry_errors": false,
        "total_rows": 1200,
        "processed_rows": 480,
        "message": "",
        "created_at": "2026-10-23T09:12:44.000Z",
        "modified_at": "2026-10-23T09:14:02.000Z",
        "credits_remaining": 2480.6
    }
}

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

Queue email verification

Stop email verification task