Seznamy k ověření

Ověřte až 10 000 adres najednou a vyexportujte výsledky.

Základní URLhttps://api.emailit.com/v2Autentizace Chyby Limity rychlosti

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

Vytvoření seznamu k ověření

Vytvoří seznam k ověření a na pozadí začne ověřovat jeho adresy. Každá adresa se kontroluje v režimu full, včetně kontroly schránky popsané na stránce Ověření adresy. Vyžaduje API klíč s oprávněním full.

POST/email-verification-lists

Tělo požadavku

namestringPovinné

Název seznamu, od 1 do 255 znaků.

emailsstring[]Povinné

Adresy k ověření, od 1 do 10 000. Každá položka musí být platná e-mailová adresa. Emailit z nich odstraní okrajové mezery, převede je na malá písmena a odstraní duplicity.

Odpověď

Vrací 201 Created se seznamem. Emailit před zahájením ověřování účtuje 5 kreditů za každou jedinečnou adresu. Odpověď uvádí, kolik adres bylo přijato (valid_emails_count, unique_emails_count) a kolik ověřovacích úloh se zařadilo do fronty (dispatched_jobs). Nový seznam má stav processing.

stats si ponechá počáteční hodnoty, dokud nejsou hotové všechny adresy; potom seznam přejde do stavu completed s konečnými počty. Opakovaně volejte endpoint Načtení seznamu k ověření, nebo poslouchejte webhookové události:

email_verification_list.created při vytvoření seznamu.
email_verification.updated pro každou adresu, jakmile je hotová.
email_verification_list.updated po dokončení seznamu.

Stavový kód	Kdy
`400`	`name` nebo `emails` chybí nebo je prázdné, `emails` má více než 10 000 položek nebo některá položka není platná adresa (standardní chyba validace).
`402`	Workspace nemá dost kreditů na všechny jedinečné adresy.

Statistiky

Pole	Popis
`total_emails`	Počet jedinečných adres v seznamu.
`processed_emails`	Adresy, jejichž zpracování skončilo, úspěšně i neúspěšně.
`successful_verifications`	Úspěšně ověřené adresy.
`failed_verifications`	Adresy, jejichž ověření skončilo chybou.
`pending_emails`	Adresy, které ještě nebyly zpracovány.

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

Výpis seznamů k ověření

Vrací vaše seznamy k ověření od nejnovějšího. Vyžaduje API klíč s oprávněním full.

GET/email-verification-lists

Parametry dotazu

pageinteger

Číslo stránky, začíná na 1. Výchozí hodnota je 1.

limitinteger

Počet seznamů na stránce, od 1 do 100. Výchozí hodnota je 10.

statusstring

Jen seznamy v tomto stavu: pending, processing, completed, failed nebo canceled.

searchstring

Hledá v názvu seznamu bez ohledu na velikost písmen.

matchstring

Hodnota all (výchozí) vyžaduje shodu se všemi filtry. S hodnotou or stačí shoda s kterýmkoli filtrem. Viz Filtrování.

orderstring

Klíč řazení pro tento výpis. Viz klíče řazení níže.

directionstring

asc, nebo desc.

Filtry a řazení

Filtry výpisů jsou jedna úroveň parametrů dotazu ve tvaru key.condition=value. Parametry match, order a direction a seznam podmínek pro každý typ najdete na stránce Filtrování.

Klíče filtrů

Klíč	Typ	Podmínky
`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

Klíče řazení

V parametru order předejte jeden z těchto klíčů a v parametru direction hodnotu asc, nebo desc: name, status, created_at

Odpověď

Vrací 200 OK se seznamy v poli data a k tomu next_page_url a previous_page_url (na začátku a na konci výpisu null). Každý seznam má pole id, name, status, stats, created_at a updated_at; pole objektu stats popisuje stránka Vytvoření seznamu k ověření.

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

Načtení seznamu k ověření

Vrací jeden seznam k ověření. Opakovaným dotazováním zjistíte, kdy má seznam stav completed, nebo místo toho naslouchejte webhookové události email_verification_list.updated. Vyžaduje API klíč s oprávněním full.

GET/email-verification-lists/:id

Parametry v cestě

idstringPovinné

ID seznamu, například evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.

Odpověď

Vrací 200 OK s poli seznamu id, name, status, stats, created_at a updated_at. Dokud je seznam ve stavu processing, ukazuje stats počáteční hodnoty; konečné počty se zapíšou po dokončení. Pole objektu stats popisuje stránka Vytvoření seznamu k ověření.

Pokud seznam ve vašem workspace neexistuje, vrací 404.

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

Výpis výsledků

Vrací jeden výsledek pro každou adresu ze seznamu k ověření, od naposledy aktualizovaného. Výsledky přibývají, jak se jednotlivé adresy dokončují, takže je můžete číst ještě před dokončením celého seznamu. Vyžaduje API klíč s oprávněním full.

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

Parametry v cestě

idstringPovinné

ID seznamu, například evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.

Parametry dotazu

pageinteger

Číslo stránky, začíná na 1. Výchozí hodnota je 1.

limitinteger

Počet výsledků na stránce, od 1 do 100. Výchozí hodnota je 50.

statusstring

Jen výsledky v tomto stavu: pending, processing, completed, failed nebo canceled.

resultstring

Jen výsledky s tímto výsledkem ověření: safe, invalid, disposable, disabled, inbox_full nebo unknown. Rolové adresy najdete filtrem result.exact=role.

matchstring

Hodnota all (výchozí) vyžaduje shodu se všemi filtry. S hodnotou or stačí shoda s kterýmkoli filtrem. Viz Filtrování.

orderstring

Klíč řazení pro tento výpis. Viz klíče řazení níže.

directionstring

asc, nebo desc.

Filtry a řazení

Filtry výpisů jsou jedna úroveň parametrů dotazu ve tvaru key.condition=value. Parametry match, order a direction a seznam podmínek pro každý typ najdete na stránce Filtrování.

Klíče filtrů

Klíč	Typ	Podmínky
`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

Klíče řazení

V parametru order předejte jeden z těchto klíčů a v parametru direction hodnotu asc, nebo desc: email, status, result, risk, created_at

Odpověď

Vrací 200 OK s výsledky v poli data a k tomu next_page_url a previous_page_url (na začátku a na konci výpisu null). Každý výsledek obsahuje id adresy (ev_…), email, status, result, score, risk, mx_records, error_message (vyplněné, když ověření selhalo) a časová razítka. result, score a risk znamenají totéž jako na stránce Ověření adresy. Výsledky jednotlivých kontrol získáte, když výsledky vyexportujete.

Pokud seznam ve vašem workspace neexistuje, vrací 404.

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

Export výsledků

Stáhne výsledky seznamu k ověření jako tabulku XLSX. Seznam musí být nejdřív ve stavu completed. Vyžaduje API klíč s oprávněním full.

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

Parametry v cestě

idstringPovinné

ID seznamu, například evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.

Odpověď

Vrací 200 OK se souborem v těle odpovědi, hlavičkou Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet a hlavičkou Content-Disposition: attachment. Soubor je pojmenovaný podle ID seznamu, například evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.xlsx.

Stavový kód	Kdy
`400`	Seznam ještě není ve stavu `completed`.
`404`	Seznam ve vašem workspace neexistuje, nebo nemá žádné výsledky k exportu.

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