# List Email Verifications

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

List the workspace's bulk email verifications, newest first. Free: no credits. `query` matches the name, `owner` is `me`, `anyone` or a user id; `per_page` up to 100.

## Authentication

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

## Query parameters

- `page` (integer, optional, min: 1, default: 1): The page, 1-based.
- `per_page` (integer, optional, min: 1, max: 100, default: 25): Jobs per page.
- `query` (string, optional, max length: 256): Case-insensitive substring match on the job name. Example: `"webinar"`
- `owner` (string, optional, max length: 64): Whose jobs: `me` (the caller's), `anyone` (the default) or a user id of the workspace. Example: `"me"`

## Example request

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

## Response 200

One page of jobs.

```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",
    "pagination": {
      "page": 1,
      "per_page": 25,
      "page_size": 25,
      "total_pages": 1,
      "total_count": 1
    }
  }
}
```

## Response 400

Invalid request (`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": "per_page must not be greater than 100",
      "payload": {
        "field": "per_page",
        "code": "out_of_range",
        "received_value": 500,
        "received_type": "number",
        "constraints": {
          "max": "per_page must not be greater than 100"
        }
      }
    }
  ]
}
```

## Response 401

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

## Response 500

Unexpected server error.