Email Validation

Get List Results

Retrieve the verification results for a completed deliverable list. Results are paginated — pass page and limit as query parameters to control which slice of data you receive.

To retrieve all results, start at page 1 and keep incrementing the page number until metadata.has_more is false.

Example pagination loop:

GET /validate/deliverable/{listId}/results?page=1&limit=100
Check metadata.has_more in the response.
If true, request the next page: ?page=2&limit=100
Repeat until has_more is false.

GET

deliverable

{listId}

results

Get deliverable list results

curl --request GET \
  --url https://api.omniverifier.com/v1/validate/deliverable/{listId}/results \
  --header 'x-api-key: <api-key>'

{
  "results": [
    {
      "email": "user@example.com",
      "status": "valid",
      "mail_server": "outlook.com"
    }
  ],
  "metadata": {
    "total_pages": 13,
    "total_count": 1250,
    "has_more": true
  }
}

Authorizations

x-api-key

string

header

required

API key for authentication

Path Parameters

listId

string

required

List ID

Query Parameters

page

integer

default:1

Page number for paginated results.

limit

integer

default:100

Maximum number of results to return per page.

Response

Successfully retrieved list results

results

object[]

Show child attributes

metadata

object

Show child attributes

Create ListCreate a new list for email catchall detection