Skip to content

Create a List Health Preview Job

Request

Start a list health preview job from a list of addresses. We will sample the list and run validations on a small percentage.

Security
basicAuth
Path
list_idstringrequired

The list health preview job id

curl -i -X POST \
  -u '<username>:<password>' \
  'https://api.mailgun.net/v4/address/validate/preview/{list_id}'

Responses

A 202 response

Bodyapplication/json
idstringrequired
messagestringrequired
Response
{ "id": "example_list_id", "message": "The validation preview was submitted." }