Listas de direcciones

Verifica hasta 10.000 direcciones de una vez y exporta los resultados.

URL basehttps://api.emailit.com/v2Autenticación Errores Límites de velocidad

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

Crear una lista

Crea una lista de direcciones y empieza a verificarlas en segundo plano. Cada dirección se comprueba en modo full, incluida la comprobación del buzón que se describe en Verificar una dirección. Requiere una clave de API con el permiso full.

POST/email-verification-lists

Cuerpo de la petición

namestringObligatorio

El nombre de la lista, de 1 a 255 caracteres.

emailsstring[]Obligatorio

Las direcciones que se van a verificar, de 1 a 10.000. Cada elemento debe ser una dirección de email válida. Emailit les quita los espacios del principio y del final, las pasa a minúsculas y elimina los duplicados.

Devuelve

Devuelve 201 Created con la lista. Emailit cobra 5 créditos por dirección única antes de que empiece la verificación. La respuesta indica cuántas direcciones se aceptaron (valid_emails_count, unique_emails_count) y cuántas tareas de verificación se pusieron en cola (dispatched_jobs). La lista nueva tiene el estado processing.

stats conserva sus valores iniciales hasta que se terminan todas las direcciones; después, la lista pasa a completed con sus recuentos finales. Consulta periódicamente Obtener una lista o escucha los eventos de webhook:

email_verification_list.created cuando se crea la lista.
email_verification.updated por cada dirección, a medida que termina.
email_verification_list.updated cuando se completa la lista.

Código	Cuándo
`400`	Falta `name` o `emails` o están vacíos, `emails` tiene más de 10.000 elementos o un elemento no es una dirección válida (error de validación estándar).
`402`	El espacio de trabajo no tiene créditos suficientes para todas las direcciones únicas.

Estadísticas

Campo	Descripción
`total_emails`	Las direcciones únicas de la lista.
`processed_emails`	Las direcciones terminadas, con o sin éxito.
`successful_verifications`	Las direcciones verificadas correctamente.
`failed_verifications`	Las direcciones cuya verificación falló con un error.
`pending_emails`	Las direcciones aún sin procesar.

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

Devuelve tus listas de direcciones, de la más reciente a la más antigua. Requiere una clave de API con el permiso full.

GET/email-verification-lists

Parámetros de consulta

pageinteger

El número de página, empezando por 1. Por defecto, 1.

limitinteger

Las listas por página, de 1 a 100. Por defecto, 10.

statusstring

Solo las listas con este estado: pending, processing, completed, failed o canceled.

searchstring

Una búsqueda sin distinguir mayúsculas y minúsculas en el nombre de la lista.

matchstring

all (por defecto) exige que se cumplan todos los filtros. or coincide con cualquier filtro. Consulta Filtrado.

orderstring

Clave de ordenación de esta lista. Consulta las claves de ordenación más abajo.

directionstring

asc o desc.

Filtros y orden

Los filtros de listado son un único nivel de parámetros de consulta key.condition=value. Consulta Filtrado para ver match, order, direction y la lista de condiciones de cada tipo.

Claves de filtro

Clave	Tipo	Condiciones
`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

Claves de ordenación

Pasa en order una de estas claves y en direction el valor asc o desc: name, status, created_at

Devuelve

Devuelve 200 OK con las listas en data, además de next_page_url y previous_page_url (null en los extremos). Cada lista tiene id, name, status, stats, created_at y updated_at; para los campos de stats, consulta Crear una lista.

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"
}

Obtener una lista

Devuelve una lista de direcciones. Consúltala periódicamente para saber cuándo pasa a completed o, en su lugar, escucha el evento de webhook email_verification_list.updated. Requiere una clave de API con el permiso full.

GET/email-verification-lists/:id

Parámetros de ruta

idstringObligatorio

El ID de la lista, por ejemplo evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.

Devuelve

Devuelve 200 OK con los campos id, name, status, stats, created_at y updated_at de la lista. Mientras una lista está en processing, stats muestra sus valores iniciales; los recuentos finales se guardan cuando termina. Para los campos de stats, consulta Crear una lista.

Devuelve 404 si la lista no existe en tu espacio de trabajo.

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 los resultados

Devuelve un resultado por cada dirección de una lista, del actualizado más recientemente al más antiguo. Los resultados aparecen a medida que terminan las direcciones, así que puedes leerlos antes de que se complete toda la lista. Requiere una clave de API con el permiso full.

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

Parámetros de ruta

idstringObligatorio

El ID de la lista, por ejemplo evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.

Parámetros de consulta

pageinteger

El número de página, empezando por 1. Por defecto, 1.

limitinteger

Los resultados por página, de 1 a 100. Por defecto, 50.

statusstring

Solo los resultados con este estado: pending, processing, completed, failed o canceled.

resultstring

Solo los resultados con este desenlace: safe, invalid, disposable, disabled, inbox_full o unknown. Para encontrar direcciones de rol, usa result.exact=role.

matchstring

all (por defecto) exige que se cumplan todos los filtros. or coincide con cualquier filtro. Consulta Filtrado.

orderstring

Clave de ordenación de esta lista. Consulta las claves de ordenación más abajo.

directionstring

asc o desc.

Filtros y orden

Los filtros de listado son un único nivel de parámetros de consulta key.condition=value. Consulta Filtrado para ver match, order, direction y la lista de condiciones de cada tipo.

Claves de filtro

Clave	Tipo	Condiciones
`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

Claves de ordenación

Pasa en order una de estas claves y en direction el valor asc o desc: email, status, result, risk, created_at

Devuelve

Devuelve 200 OK con los resultados en data, además de next_page_url y previous_page_url (null en los extremos). Cada resultado tiene el id de la dirección (ev_…), email, status, result, score, risk, mx_records, error_message (presente si la verificación falló) y las marcas de tiempo. result, score y risk significan lo mismo que en Verificar una dirección. Para ver todas las comprobaciones, exporta los resultados.

Devuelve 404 si la lista no existe en tu espacio de trabajo.

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 los resultados

Descarga los resultados de una lista de direcciones como hoja de cálculo XLSX. La lista debe estar antes en completed. Requiere una clave de API con el permiso full.

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

Parámetros de ruta

idstringObligatorio

El ID de la lista, por ejemplo evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.

Devuelve

Devuelve 200 OK con el archivo como cuerpo de la respuesta, Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet y una cabecera Content-Disposition: attachment. El archivo lleva el ID de la lista como nombre, por ejemplo evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.xlsx.

Código	Cuándo
`400`	La lista aún no está en `completed`.
`404`	La lista no existe en tu espacio de trabajo o no tiene resultados que 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"
}