Listas de verificação
Verifique até 10.000 endereços de uma vez e exporte os resultados.
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.
/email-verification-listsCorpo da requisição
namestringObrigatórioNome da lista, de 1 a 255 caracteres.
emailsstring[]ObrigatórioEndereç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 é atualizado conforme cada endereço termina. Quando todos os endereços têm um resultado final, a lista passa para completed. Consulte periodicamente Obter uma lista ou aguarde os eventos de webhook:
email_verification_list.createdquando a lista é criada.email_verification.updatedpara cada endereço, à medida que termina.email_verification_list.updatedquando 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 um resultado ou com um erro. |
successful_verifications |
Endereços com um resultado final, seja ele qual for. Isso não significa que os endereços sejam válidos; consulte results. |
failed_verifications |
Endereços que um erro impediu o Emailit de verificar. |
pending_emails |
Endereços ainda não concluídos, incluindo os que aguardam uma nova tentativa após greylisting. |
results |
Endereços concluídos por resultado: safe, role, catch_all, unknown, inbox_full, disabled, disposable e invalid. As listas mais antigas podem não ter esse campo. |
{
"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,
"results": {
"safe": 0,
"role": 0,
"catch_all": 0,
"unknown": 0,
"inbox_full": 0,
"disabled": 0,
"disposable": 0,
"invalid": 0
}
},
"created_at": "2026-10-01T10:30:02.441000+00:00"
}{
"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.
/email-verification-listsParâmetros de consulta
pageintegerNúmero da página, a partir de 1. Padrão 1.
limitintegerListas por página, de 1 a 100. Padrão 10.
statusstringApenas as listas com este status: pending, processing, completed, failed ou canceled.
searchstringBusca sem diferenciar maiúsculas de minúsculas no nome da lista.
matchstringall (padrão) exige todos os filtros. or corresponde a qualquer filtro. Consulte Filtragem.
orderstringChave de ordenação desta lista. Consulte as chaves de ordenação abaixo.
directionstringasc 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 | Observaçõ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.
{
"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,
"results": {
"safe": 702,
"role": 41,
"catch_all": 88,
"unknown": 37,
"inbox_full": 3,
"disabled": 6,
"disposable": 12,
"invalid": 107
}
},
"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
}{
"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.
/email-verification-lists/:idParâmetros de caminho
idstringObrigatórioID da lista, por exemplo, evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.
Retorno
Retorna 200 OK com id, name, status, stats, created_at e updated_at da lista. stats é atualizado conforme cada endereço termina, então você pode acompanhar o progresso de uma lista processing. Consulte Criar uma lista para os campos de stats.
Retorna 404 se a lista não existir no seu workspace.
{
"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,
"results": {
"safe": 702,
"role": 41,
"catch_all": 88,
"unknown": 37,
"inbox_full": 3,
"disabled": 6,
"disposable": 12,
"invalid": 107
}
},
"created_at": "2026-10-01T10:30:02.441000+00:00",
"updated_at": "2026-10-01T10:41:57.020000+00:00"
}{
"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.
/email-verification-lists/:id/resultsParâmetros de caminho
idstringObrigatórioID da lista, por exemplo, evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.
Parâmetros de consulta
pageintegerNúmero da página, a partir de 1. Padrão 1.
limitintegerResultados por página, de 1 a 100. Padrão 50.
statusstringApenas os resultados com este status: pending, processing, completed, failed ou canceled.
resultstringApenas os resultados com este desfecho: safe, role, catch_all, unknown, inbox_full, disabled, disposable ou invalid.
matchstringall (padrão) exige todos os filtros. or corresponde a qualquer filtro. Consulte Filtragem.
orderstringChave de ordenação desta lista. Consulte as chaves de ordenação abaixo.
directionstringasc 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 | Observaçõ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 é um objeto email_verification com os mesmos campos que Verificar um endereço retorna: id (evr_…), email, status, result, score, risk, mode, checks, address, did_you_mean, mx_records e timestamps. Um endereço que ainda está pending ou processing ainda não tem um resultado final. Um endereço que um erro interrompeu tem o status failed e o resultado error; encontre esses endereços com status=failed.
Retorna 404 se a lista não existir no seu workspace.
{
"data": [
{
"id": "evr_2xLeA1Pn6Rw3Ks8Vb0Ht5Mq2Fd9c",
"object": "email_verification",
"email": "ada@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "full",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": false,
"deliverable": true,
"disabled": false,
"catch_all": false,
"free_email": false,
"smtp_connect": true,
"has_mx_records": true,
"domain_age": 10957,
"gibberish": false
},
"address": {
"mailbox": "ada",
"domain": "example.com",
"suffix": null,
"root": "ada@example.com"
},
"did_you_mean": null,
"mx_records": [
{ "priority": 10, "exchange": "mx1.example.com" }
],
"created_at": "2026-10-01T10:30:02.441000+00:00",
"updated_at": "2026-10-01T10:30:09.876000+00:00"
},
{
"id": "evr_2xLeA2Qm7Sx4Lt9Wc1Ju6Nr3Ge0d",
"object": "email_verification",
"email": "grace@example.com",
"status": "completed",
"score": 0,
"risk": "high",
"result": "invalid",
"mode": "full",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": false,
"deliverable": false,
"disabled": false,
"catch_all": false,
"free_email": false,
"smtp_connect": true,
"has_mx_records": true,
"domain_age": 10957,
"gibberish": false
},
"address": {
"mailbox": "grace",
"domain": "example.com",
"suffix": null,
"root": "grace@example.com"
},
"did_you_mean": null,
"mx_records": [
{ "priority": 10, "exchange": "mx1.example.com" }
],
"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
}{
"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.
/email-verification-lists/:id/exportParâmetros de caminho
idstringObrigatórioID 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. |
HTTP/1.1 200 OK
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Content-Disposition: attachment; filename="evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.xlsx"
<binary XLSX data>{
"statusCode": 400,
"error": "Bad Request",
"message": "Cannot export incomplete list. List must be completed first."
}{
"statusCode": 404,
"error": "Not Found",
"message": "Email verification list not found"
}