Skip to main content
POST
/
catchall
/
new
Create new catchall list
curl --request POST \
  --url https://api.omniverifier.com/v1/validate/catchall/new \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "emails": 1000,
  "title": "My catchall detection list"
}
'
{
  "id": 12346,
  "estimated_emails": 1000,
  "current_balance": 500
}

Authorizations

​
x-api-key
string
header
required

API key for authentication

Body

application/json
​
emails
integer
required

Number of emails to be processed

Required range: x >= 1
Example:

1000

​
title
string

Optional list title

Example:

"My catchall detection list"

Response

Successfully created list

​
id
integer

List ID

Example:

12346

​
estimated_emails
integer

Number of emails in the list

Example:

1000

​
current_balance
integer

Remaining credit balance

Example:

500