Cancel Email Verification

POST/v2/email-verifications/{id}/cancel

Cancel a bulk email verification job and refund the credits of the rows it has not verified. Free: no credits. A job is cancellable while queued, counting, awaiting_confirmation or verifying; the refund is made at most once.

Path parameters

idstringrequired
The verification job id: the id that POST /v2/email-verifications answers and GET /v2/email-verifications lists.

Responses

200 The job, cancelled.
400 Malformed id (VALIDATION_ERROR, no payload.code).
401 Missing, unknown or inactive credentials (UNAUTHORIZED).
404 No such record in this workspace (NOT_FOUND).
409 The job is already finished (CONFLICT, invalid_state; payload.status names its state).
500 Unexpected server error.

For error handling see Errors.

curl --request POST \
  --url https://api.getprospect.com/v2/email-verifications/{id}/cancel \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'

Response

{
  "success": true,
  "data": {
    "id": "6703f1c2a9e4b5d6c7f80912",
    "name": "webinar-leads.csv",
    "source": "file",
    "status": "cancelled",
    "stopped_reason": "cancelled_by_user",
    "counts": {
      "total_rows": 1200,
      "parsed_rows": 1200,
      "billable": 1130,
      "duplicates": 42,
      "invalid_syntax": 18,
      "blank": 10,
      "verified": 400,
      "valid": 290,
      "invalid": 80,
      "accept_all": 22,
      "unknown": 8
    },
    "batches": {
      "total": 12,
      "done": 4
    },
    "progress_percent": 0,
    "result_files": null,
    "result_expires_at": null,
    "results_expires_at": null,
    "links": {
      "self": "/v2/email-verifications/6703f1c2a9e4b5d6c7f80912",
      "job": "/v2/jobs/6703f1c2a9e4b5d6c7f80912",
      "results": null
    },
    "owner": {
      "id": "64b7c0ffee0123456789abcd",
      "first_name": "Emily",
      "last_name": "Carter",
      "photo_url": null
    },
    "created_by": {
      "id": "64b7c0ffee0123456789abcd",
      "name": "Emily Carter"
    },
    "error": null,
    "created_at": "2026-10-08T14:05:12.000Z",
    "updated_at": "2026-10-08T14:07:55.000Z"
  },
  "metadata": {
    "timestamp": "2026-10-08T14:07:55.000Z"
  }
}