Bulk Emails

These endpoints let you verify multiple emails.

POST/bulk

Verify bulk Email

This endpoint allows you to verify bulk email addresses.

Request

POST

/bulk

curl --location 'https://api.mailverify.ai/api/v1/verify/bulk' \
--header 'x-auth-mailverify: apiKey' \
--form 'Test BULK upload=@"PATH_TO_FILE.csv"'

Response

{"listId":"325"}

PUT/start

Start List Verification

This endpoint allows you to start the verification process for a specified list.

Request

PUT

/start

curl --location 'https://api.mailverify.ai/api/v1/verify/start' \
--header 'Content-Type: application/json' \
--header 'x-auth-mailverify: apiKey' \
--data-raw '{
  "listId": "12345"
}'

Response

{"message":"List Verification Started"}

GET/bulk_emails

Get Emails in a List

This endpoint allows you to fetch list of emails by passing the list ID.

Request

GET

/bulk_emails

curl --location 'https://api.mailverify.ai/api/v1/verify/bulk_emails?listID=1234' \
--header 'x-auth-mailverify: apiKey'

Response

{
"count": 1,
"emails": [
    {
        "id": "1202881",
        "email": "[email protected]",
        "free": true,
        "disposable": false,
        "catchAll": false,
        "mailboxFull": false,
        "role": false,
        "listId": "325",
        "validationStatus": "DELIVERABLE",
        "reason": "",
        "createdAt": "2024-12-04T13:36:30.756Z",
        "updatedAt": "2024-12-04T13:41:45.751Z",
        "deletedAt": null
    }
]
}

GET/list

Bulk List

This endpoint allows you to fetch the list of email verification requests.

Request

GET

/lists

curl --location 'https://api.mailverify.ai/api/v1/verify/lists' \
--header 'x-auth-mailverify: apiKey'

Response

{
"count": 1,
"lists": [
    {
        "id": "296",
        "name": "test",
        "activeVerification": false,
        "activeVerificationDurationInDays": null,
        "emailsLastVerifiedAt": null,
        "status": null,
        "stats": {
            "totalEmail": "2",
            "deliverable": "0",
            "undeliverable": "0",
            "risky": "0",
            "unknown": "0",
            "duplicates": 0,
            "inQueue": "0",
            "validCatchAll": "0"
        },
        "createdAt": "2024-12-02T19:26:05.186Z",
        "updatedAt": "2024-12-02T19:26:05.186Z",
        "deletedAt": null
    },
    
]
}

GET/overall_stats

Overall List statistics

This endpoint allows you to fetch overall statistics for a specific verification list by providing a listId.

Request

GET

/verify/overall_stats

curl 'https://api.mailverify.ai/api/v1/verify/overall_stats?listId=1234' \
   --header 'x-auth-mailverify: apiKey'

Response

{
    "stats": {
        "totalEmail": "1000",
        "deliverable": "0",
        "undeliverable": "0",
        "risky": "0",
        "unknown": "0",
        "duplicates": 0,
        "inQueue": "0",
        "validCatchAll": "0"
    }
}

DELETE/list

Delete Email List

This endpoint allows you to delete an existing verification list.

Request

DELETE

/list

curl --location --request DELETE 'https://api.mailverify.ai/api/v1/verify/list' \
--header 'Content-Type: application/json' \
--header 'x-auth-mailverify: apiKey' \
--data-raw '{
  "listId": "12345"
}'

Response

{"message":"List Deleted"}

GET/export_list

Export History

This endpoint allows you to fetch the export history of verification lists.

Request

GET

/export_list

curl --location 'https://api.mailverify.ai/api/v1/verify/export_list?listId=1234' \
--header 'x-auth-mailverify: apiKey'

Response

{
"export_list": [
    {
        "exportedTo": "CSV",
        "status": "DONE",
        "filters": [
            "DELIVERABLE",
            "UNDELIVERABLE",
            "RISKY",
            "UNKNOWN",
            "VALID CATCH ALL"
        ],
        "doneAt": "2024-12-04T14:42:25.463Z"
    }
]
}

GET/export_csv

Export CSV

This endpoint allows you to export a verification list to a CSV file.

Request

POST

/verify/export_csv

curl --location 'https://api.mailverify.ai/api/v1/verify/export_csv' \
--header 'Content-Type: application/json' \
--header 'x-auth-mailverify: apiKey' \
--data-raw '{
  "listId": "325",
  "validationFilters": ["DELIVERABLE", "UNDELIVERABLE", "RISKY", "UNKNOWN", "VALID CATCH ALL"],
  "attributeFilters": {
    "free": false,
    "disposable": false,
    "catchAll": false,
    "mailboxFull": false,
    "role": false
  },
  "reasonFilters": [],
  "providerFilters": [],
  "domainFilters": [],
  "preset": "all"
}'

Response

{
    "url": "https://cdn.mailverify.ai/export_list_mailverify/new-all-1737991486355.csv"
}