Get request's status

POST https://emailverification.whoisxmlapi.com/api/bevService/request/status

CURL request sample

curl https://emailverification.whoisxmlapi.com/api/bevService/request/status -X POST -H "Content-Type: application/json"  -d '{"apiKey": "YOUR_API_KEY", "ids": [622], "format": "json"}'

POST request body sample

{
    "apiKey": "YOUR_API_KEY",
    "ids": [544, 595, 596],
    "format": "json"
}

Input parameters

apiKey

Required. Get your personal API key on the My products page.

ids

Required. Array.

Required requests' IDs.

format

Optional. String.

Used to specify the response format.

Allowed values: "xml", "json", "csv".

Default value: "json".

Sample output

{
    "response": [
        {
            "id": 544,
            "api_version": 2,
            "date_start": "1528204702",
            "total_emails": 500,
            "invalid_emails": 0,
            "processed_emails": 500,
            "failed_emails": 0,
            "ready": 1
        },
        {
            "id": 595,
            "api_version": 3,
            "date_start": "1528377227",
            "total_emails": 20,
            "invalid_emails": 0,
            "processed_emails": 20,
            "failed_emails": 0,
            "ready": 1
        },
        {
            "id": 596,
            "date_start": "1528377253",
            "total_emails": 3,
            "invalid_emails": 0,
            "processed_emails": 3,
            "failed_emails": 0,
            "ready": 1
        }
    ]
}

Code: 200 OK.
response

The response object.

Contains an array of user's requests' info on success. This array can be empty in case the 'ids' array contains non-existing ids only.

In case of an error it contains its description in the 'error' field. If there are multiple errors their descriptions are returned in the 'errors' array.

id

Integer.

Request ID.

api_version

Integer.

API version used for the request.

date_start

String.

String representation of the request's start Unix timestamp.

total_emails

Integer.

The total number of emails in the request.

invalid_emails

Integer.

Number of invalid emails.

processed_emails

Integer.

Number of already processed email addresses.

failed_emails

Integer.

Number of emails that could not be processed.

ready

Integer.

1 if processing has finished, 0 – otherwise.