# Get Email Verification

`GET https://api.getprospect.com/v2/email-verifications/{id}`

Read one bulk email verification job; poll it while the job is active. Free: no credits. The same id reads as a generic job at `GET /v2/jobs/{id}`.

## Authentication

Pass your API key in the `x-api-key` header.

## Path parameters

- `id` (string, required): The verification job id: the `id` that `POST /v2/email-verifications` answers and `GET /v2/email-verifications` lists.

## Example request

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

## Response 200

The job.

```json
{
  "success": true,
  "data": {
    "id": "6703f1c2a9e4b5d6c7f80912",
    "name": "webinar-leads.csv",
    "source": "file",
    "status": "awaiting_confirmation",
    "stopped_reason": null,
    "counts": {
      "total_rows": 1200,
      "parsed_rows": 1200,
      "billable": 1130,
      "duplicates": 42,
      "invalid_syntax": 18,
      "blank": 10,
      "verified": 0,
      "valid": 0,
      "invalid": 0,
      "accept_all": 0,
      "unknown": 0
    },
    "batches": {
      "total": 0,
      "done": 0
    },
    "progress_percent": 100,
    "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:05:12.000Z"
  },
  "metadata": {
    "timestamp": "2026-10-08T14:07:55.000Z"
  }
}
```

## Response 400

Malformed id (`VALIDATION_ERROR`, no `payload.code`).

```json
{
  "success": false,
  "data": null,
  "metadata": {
    "timestamp": "2026-10-08T14:07:55.000Z"
  },
  "errors": [
    {
      "name": "VALIDATION_ERROR",
      "message": "\"abc\" is not a valid id."
    }
  ]
}
```

## Response 401

Missing, unknown or inactive credentials (`UNAUTHORIZED`).

## Response 404

No such record in this workspace (`NOT_FOUND`).

```json
{
  "success": false,
  "data": null,
  "metadata": {
    "timestamp": "2026-10-08T14:07:55.000Z"
  },
  "errors": [
    {
      "name": "NOT_FOUND",
      "message": "Email verification 6703f1c2a9e4b5d6c7f80912 not found."
    }
  ]
}
```

## Response 500

Unexpected server error.