# Get Email Verification Results

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

Read the results of a `completed` email verification created from `data.emails`: one item per address in request order (a repeated address at each of its positions), with its `status`, `provider`, `domain` and `free_email`. Pages of up to 500 (`limit`, default 100): send `metadata.pagination.next_cursor` back as `cursor` until it is null; `status` keeps one kind of row. Kept until `results_expires_at` (30 days after completion). A job created in the App answers 409 `results_unavailable`: its output is `result_files`. Free; a `poll` (0 rate-limit units, per-second window only).

## 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.

## Query parameters

- `cursor` (string, optional): Opaque cursor: `metadata.pagination.next_cursor` of the previous page. Absent for the first page; the last page answers `next_cursor: null`.
- `limit` (integer, optional, min: 1, max: 500, default: 100): Rows per page.
- `status` (enum, optional): Only the rows with this result `status`. Allowed values: `valid`, `invalid`, `accept_all`, `unknown`.

## Example request

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

## Response 200

One page of results.

```json
{
  "success": true,
  "data": [
    {
      "email": "emily.carter.sample@intercom.com",
      "status": "valid",
      "provider": "aspmx.l.google.com",
      "domain": "intercom.com",
      "free_email": false
    },
    {
      "email": "emily.carter.sample@intercom.com",
      "status": "valid",
      "provider": "aspmx.l.google.com",
      "domain": "intercom.com",
      "free_email": false
    },
    {
      "email": "not-an-address",
      "status": "invalid",
      "provider": "",
      "domain": "",
      "free_email": null
    }
  ],
  "metadata": {
    "timestamp": "2026-10-08T14:07:55.000Z",
    "pagination": {
      "next_cursor": "Mg",
      "limit": 3
    }
  }
}
```

## Response 400

A malformed id (`VALIDATION_ERROR`, no code), a malformed query, or a `cursor` no page handed out (`VALIDATION_ERROR`; `payload.code` says which kind of mistake).

```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 409

`CONFLICT`: the job is not `completed` yet (`invalid_state`, `payload.status` names its state), or it was created in the App, whose output is `result_files` (`results_unavailable`).

```json
{
  "success": false,
  "data": null,
  "metadata": {
    "timestamp": "2026-10-08T14:07:55.000Z"
  },
  "errors": [
    {
      "name": "CONFLICT",
      "message": "The email verification is verifying; results are served once it is completed.",
      "payload": {
        "code": "invalid_state",
        "status": "verifying"
      }
    }
  ]
}
```

## Response 410

The results were removed at `results_expires_at` (`GONE`, `results_expired`).

```json
{
  "success": false,
  "data": null,
  "metadata": {
    "timestamp": "2026-10-08T14:07:55.000Z"
  },
  "errors": [
    {
      "name": "GONE",
      "message": "The results of this email verification expired at 2026-11-07T14:21:40.000Z.",
      "payload": {
        "code": "results_expired"
      }
    }
  ]
}
```

## Response 429

Over the `poll` rate limit (`RATE_LIMIT`); wait `Retry-After` seconds. Sent only where rate limits are enforced for the caller channel.

## Response 500

Unexpected server error.