Listas de verificação

Verifique até 10.000 endereços de uma vez e exporte os resultados.

URL basehttps://api.emailit.com/v2Autenticação Erros Limites de requisições

POST/email-verification-lists
GET/email-verification-lists
GET/email-verification-lists/{id}
GET/email-verification-lists/{id}/results
GET/email-verification-lists/{id}/export

Criar uma lista

Cria uma lista de verificação e começa a verificar os endereços dela em segundo plano. Cada endereço é verificado no modo full, incluindo a verificação da caixa de e-mail descrita em Verificar um endereço. Requer uma chave de API com escopo full.

POST/email-verification-lists

Corpo da requisição

namestringObrigatório

Nome da lista, de 1 a 255 caracteres.

emailsstring[]Obrigatório

Endereços a verificar, de 1 a 10.000. Cada item deve ser um endereço de e-mail válido. O Emailit remove os espaços das extremidades, converte para minúsculas e remove os duplicados.

Retorno

Retorna 201 Created com a lista. O Emailit cobra 5 créditos por endereço único antes de a verificação começar. A resposta informa quantos endereços foram aceitos (valid_emails_count, unique_emails_count) e quantos jobs de verificação foram colocados na fila (dispatched_jobs). A nova lista tem o status processing.

stats mantém os valores iniciais até que todos os endereços sejam concluídos; então a lista passa para completed com as contagens finais. Consulte periodicamente Obter uma lista ou aguarde os eventos de webhook:

email_verification_list.created quando a lista é criada.
email_verification.updated para cada endereço, à medida que termina.
email_verification_list.updated quando a lista é concluída.

Status	Quando
`400`	`name` ou `emails` está ausente ou vazio, `emails` tem mais de 10.000 itens ou um item não é um endereço válido (erro de validação padrão).
`402`	O workspace não tem créditos suficientes para todos os endereços únicos.

Estatísticas

Campo	Descrição
`total_emails`	Endereços únicos na lista.
`processed_emails`	Endereços concluídos, com ou sem sucesso.
`successful_verifications`	Endereços verificados com sucesso.
`failed_verifications`	Endereços cuja verificação falhou com um erro.
`pending_emails`	Endereços ainda não processados.

POST/email-verification-lists

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const list = await emailit.emailVerificationLists.create({ name: 'October newsletter import', emails: ['ada@example.com', 'grace@example.com'] });

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

vlist = client.email_verification_lists.create({"name": "October newsletter import", "emails": ["ada@example.com", "grace@example.com"]})

PHP

$emailit = Emailit::client('your_api_key');

$list = $emailit->emailVerificationLists()->create(['name' => 'October newsletter import', 'emails' => ['ada@example.com', 'grace@example.com']]);

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

list = client.email_verification_lists.create(name: "October newsletter import", emails: ["ada@example.com", "grace@example.com"])

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

list, err := client.EmailVerificationLists.Create(&emailit.CreateEmailVerificationListRequest{Name: "October newsletter import", Emails: []string{"ada@example.com", "grace@example.com"}})

Rust

use emailit::Emailit;
let emailit = Emailit::new("your_api_key");

let list = emailit.email_verification_lists.create(emailit::types::CreateEmailVerificationListParams::new("October newsletter import", vec!["ada@example.com".into(), "grace@example.com".into()])).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject list = emailit.emailVerificationLists().create(EmailVerificationListCreateParams.builder().setName("October newsletter import").setEmails(Arrays.asList("ada@example.com", "grace@example.com")).build());

using Emailit;

var emailit = new EmailitClient("your_api_key");

var list = emailit.EmailVerificationLists.Create(new EmailVerificationListCreateOptions { Name = "October newsletter import", Emails = new[] { "ada@example.com", "grace@example.com" } });

PHP

use Emailit\Laravel\Facades\Emailit;

$list = Emailit::emailVerificationLists()->create(['name' => 'October newsletter import', 'emails' => ['ada@example.com', 'grace@example.com']]);

Terminal

curl -X POST https://api.emailit.com/v2/email-verification-lists \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "October newsletter import", "emails": ["ada@example.com", "grace@example.com"]}'

JSON

{
  "id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
  "name": "October newsletter import",
  "valid_emails_count": 2,
  "unique_emails_count": 2,
  "invalid_emails_count": 0,
  "status": "processing",
  "dispatched_jobs": 2,
  "stats": {
    "total_emails": 2,
    "processed_emails": 0,
    "successful_verifications": 0,
    "failed_verifications": 0,
    "pending_emails": 2
  },
  "created_at": "2026-10-01T10:30:02.441000+00:00"
}

JSON

{
  "statusCode": 402,
  "error": "Payment Required",
  "message": "Insufficient credits for email verification list."
}

Listar listas

Retorna as suas listas de verificação de e-mails, das mais recentes para as mais antigas. Requer uma chave de API com escopo full.

GET/email-verification-lists

Parâmetros de consulta

pageinteger

Número da página, a partir de 1. Padrão 1.

limitinteger

Listas por página, de 1 a 100. Padrão 10.

statusstring

Apenas as listas com este status: pending, processing, completed, failed ou canceled.

searchstring

Busca sem diferenciar maiúsculas de minúsculas no nome da lista.

matchstring

all (padrão) exige todos os filtros. or corresponde a qualquer filtro. Consulte Filtragem.

orderstring

Chave de ordenação desta lista. Consulte as chaves de ordenação abaixo.

directionstring

asc ou desc.

Filtros e ordenação

Os filtros de listagem são um único nível de parâmetros de consulta key.condition=value. Consulte Filtragem para match, order, direction e a lista de condições por tipo.

Chaves de filtro

Chave	Tipo	Condições
`name`	string	exact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
`status`	string	exact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
`created_at`	date	exact, before, after, empty, not_empty

Chaves de ordenação

Passe em order uma destas chaves e em direction o valor asc ou desc: name, status, created_at

Retorno

Retorna 200 OK com as listas em data, além de next_page_url e previous_page_url (null nas extremidades). Cada lista tem id, name, status, stats, created_at e updated_at; consulte Criar uma lista para os campos de stats.

GET/email-verification-lists

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const lists = await emailit.emailVerificationLists.list();

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

vlists = client.email_verification_lists.list()

PHP

$emailit = Emailit::client('your_api_key');

$lists = $emailit->emailVerificationLists()->list();

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

lists = client.email_verification_lists.list

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

lists, err := client.EmailVerificationLists.List(nil)

Rust

use emailit::Emailit;
let emailit = Emailit::new("your_api_key");

let lists = emailit.email_verification_lists.list(None).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject lists = emailit.emailVerificationLists().list();

using Emailit;

var emailit = new EmailitClient("your_api_key");

var lists = emailit.EmailVerificationLists.List();

PHP

use Emailit\Laravel\Facades\Emailit;

$lists = Emailit::emailVerificationLists()->list();

Terminal

curl -X GET https://api.emailit.com/v2/email-verification-lists \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json"

JSON

{
  "data": [
    {
      "id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
      "name": "October newsletter import",
      "status": "completed",
      "stats": {
        "total_emails": 1000,
        "processed_emails": 1000,
        "successful_verifications": 996,
        "failed_verifications": 4,
        "pending_emails": 0
      },
      "created_at": "2026-10-01T10:30:02.441000+00:00",
      "updated_at": "2026-10-01T10:41:57.020000+00:00"
    }
  ],
  "next_page_url": "/v2/email-verification-lists?page=2&limit=10",
  "previous_page_url": null
}

JSON

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API key"
}

Obter uma lista

Retorna uma lista de verificação de e-mails. Consulte-a periodicamente para saber quando uma lista fica completed ou, em vez disso, aguarde o evento de webhook email_verification_list.updated. Requer uma chave de API com escopo full.

GET/email-verification-lists/:id

Parâmetros de caminho

idstringObrigatório

ID da lista, por exemplo, evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.

Retorno

Retorna 200 OK com id, name, status, stats, created_at e updated_at da lista. Enquanto uma lista está processing, stats mostra os valores iniciais; as contagens finais são gravadas quando ela termina. Consulte Criar uma lista para os campos de stats.

Retorna 404 se a lista não existir no seu workspace.

GET/email-verification-lists/{id}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const list = await emailit.emailVerificationLists.get('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

vlist = client.email_verification_lists.get("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a")

PHP

$emailit = Emailit::client('your_api_key');

$list = $emailit->emailVerificationLists()->get('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

list = client.email_verification_lists.get("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

list, err := client.EmailVerificationLists.Get("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a")

Rust

use emailit::Emailit;
let emailit = Emailit::new("your_api_key");

let list = emailit.email_verification_lists.get("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a").await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject list = emailit.emailVerificationLists().get("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a");

using Emailit;

var emailit = new EmailitClient("your_api_key");

var list = emailit.EmailVerificationLists.Get("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a");

PHP

use Emailit\Laravel\Facades\Emailit;

$list = Emailit::emailVerificationLists()->get('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a');

Terminal

curl -X GET https://api.emailit.com/v2/email-verification-lists/evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json"

JSON

{
  "id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
  "name": "October newsletter import",
  "status": "completed",
  "stats": {
    "total_emails": 1000,
    "processed_emails": 1000,
    "successful_verifications": 996,
    "failed_verifications": 4,
    "pending_emails": 0
  },
  "created_at": "2026-10-01T10:30:02.441000+00:00",
  "updated_at": "2026-10-01T10:41:57.020000+00:00"
}

JSON

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Email verification list not found"
}

Listar resultados

Retorna um resultado por endereço de uma lista de verificação, dos atualizados mais recentemente para os mais antigos. Os resultados aparecem à medida que os endereços terminam, então você pode lê-los antes de a lista inteira ser concluída. Requer uma chave de API com escopo full.

GET/email-verification-lists/:id/results

Parâmetros de caminho

idstringObrigatório

ID da lista, por exemplo, evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.

Parâmetros de consulta

pageinteger

Número da página, a partir de 1. Padrão 1.

limitinteger

Resultados por página, de 1 a 100. Padrão 50.

statusstring

Apenas os resultados com este status: pending, processing, completed, failed ou canceled.

resultstring

Apenas os resultados com este desfecho: safe, invalid, disposable, disabled, inbox_full ou unknown. Para encontrar endereços genéricos, use result.exact=role.

matchstring

all (padrão) exige todos os filtros. or corresponde a qualquer filtro. Consulte Filtragem.

orderstring

Chave de ordenação desta lista. Consulte as chaves de ordenação abaixo.

directionstring

asc ou desc.

Filtros e ordenação

Os filtros de listagem são um único nível de parâmetros de consulta key.condition=value. Consulte Filtragem para match, order, direction e a lista de condições por tipo.

Chaves de filtro

Chave	Tipo	Condições
`email`	string	exact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
`status`	string	exact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
`result`	string	exact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
`risk`	string	exact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
`created_at`	date	exact, before, after, empty, not_empty

Chaves de ordenação

Passe em order uma destas chaves e em direction o valor asc ou desc: email, status, result, risk, created_at

Retorno

Retorna 200 OK com os resultados em data, além de next_page_url e previous_page_url (null nas extremidades). Cada resultado tem o id do endereço (ev_…), email, status, result, score, risk, mx_records, error_message (preenchido quando a verificação falhou) e timestamps. result, score e risk têm o mesmo significado que em Verificar um endereço. Para ver todas as verificações, exporte os resultados.

Retorna 404 se a lista não existir no seu workspace.

GET/email-verification-lists/{id}/results

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const results = await emailit.emailVerificationLists.results('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a', { page: 1, limit: 10 });

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

results = client.email_verification_lists.results("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a", {"page": 1, "limit": 10})

PHP

$emailit = Emailit::client('your_api_key');

$results = $emailit->emailVerificationLists()->results('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a', ['page' => 1, 'limit' => 10]);

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

results = client.email_verification_lists.results("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a", page: 1, limit: 10)

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

results, err := client.EmailVerificationLists.Results("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a", nil)

Rust

use emailit::Emailit;
let emailit = Emailit::new("your_api_key");

let results = emailit.email_verification_lists.results("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a", None).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject results = emailit.emailVerificationLists().results("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a");

using Emailit;

var emailit = new EmailitClient("your_api_key");

var results = emailit.EmailVerificationLists.Results("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a");

PHP

use Emailit\Laravel\Facades\Emailit;

$results = Emailit::emailVerificationLists()->results('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a', ['page' => 1, 'limit' => 10]);

Terminal

curl -X GET "https://api.emailit.com/v2/email-verification-lists/evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a/results?page=1&limit=10" \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json"

JSON

{
  "data": [
    {
      "id": "ev_2xLeA1Pn6Rw3Ks8Vb0Ht5Mq2Fd9c",
      "email": "ada@example.com",
      "status": "completed",
      "result": "safe",
      "score": 100,
      "risk": "low",
      "mx_records": [
        { "priority": 10, "exchange": "mx1.example.com" }
      ],
      "error_message": null,
      "created_at": "2026-10-01T10:30:02.441000+00:00",
      "updated_at": "2026-10-01T10:30:09.876000+00:00"
    },
    {
      "id": "ev_2xLeA2Qm7Sx4Lt9Wc1Ju6Nr3Ge0d",
      "email": "info@acme-typo.example",
      "status": "completed",
      "result": "invalid",
      "score": 25,
      "risk": "high",
      "mx_records": [],
      "error_message": null,
      "created_at": "2026-10-01T10:30:02.441000+00:00",
      "updated_at": "2026-10-01T10:30:08.112000+00:00"
    }
  ],
  "next_page_url": "/v2/email-verification-lists/evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a/results?page=2&limit=50",
  "previous_page_url": null
}

JSON

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Email verification list not found"
}

Exportar resultados

Baixa os resultados de uma lista de verificação como planilha XLSX. A lista precisa estar completed antes. Requer uma chave de API com escopo full.

GET/email-verification-lists/:id/export

Parâmetros de caminho

idstringObrigatório

ID da lista, por exemplo evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.

Retorno

Retorna 200 OK com o arquivo como corpo da resposta, Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet e um cabeçalho Content-Disposition: attachment. O nome do arquivo é o ID da lista, por exemplo evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.xlsx.

Status	Quando
`400`	A lista ainda não está `completed`.
`404`	A lista não existe no seu workspace ou não tem resultados para exportar.

GET/email-verification-lists/{id}/export

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const exported = await emailit.emailVerificationLists.export('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

exported = client.email_verification_lists.export("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a")

PHP

$emailit = Emailit::client('your_api_key');

$exported = $emailit->emailVerificationLists()->export('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

exported = client.email_verification_lists.export("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

exported, err := client.EmailVerificationLists.Export("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a")

Rust

use emailit::Emailit;
let emailit = Emailit::new("your_api_key");

let exported = emailit.email_verification_lists.export("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a").await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

ApiResponse exported = emailit.emailVerificationLists().export("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a");

using Emailit;

var emailit = new EmailitClient("your_api_key");

var exported = emailit.EmailVerificationLists.Export("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a");

PHP

use Emailit\Laravel\Facades\Emailit;

$exported = Emailit::emailVerificationLists()->export('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a');

Terminal

curl -X GET "https://api.emailit.com/v2/email-verification-lists/evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a/export" \
  -H "Authorization: Bearer your_api_key" \
  -o verification_results.xlsx

HTTP

HTTP/1.1 200 OK
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Content-Disposition: attachment; filename="evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.xlsx"

<binary XLSX data>

JSON

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "Cannot export incomplete list. List must be completed first."
}

JSON

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Email verification list not found"
}