# Ověření seznamu

> Ověřte až 10 000 e-mailových adres najednou jejich vložením nebo nahráním souboru CSV či XLSX, sledujte průběh, projděte výsledky a vyexportujte je jako XLSX.

Seznam k ověření zkontroluje mnoho adres najednou, například před importem kontaktů z jiného systému nebo před odesláním kampaně na starý seznam. Tento návod ukazuje, jak seznam vytvořit, sledovat jeho průběh, číst výsledky a vyexportovat je.

## Než začnete

- Seznam může obsahovat až 10 000 adres. Větší soubory rozdělte do více seznamů.
- Každá unikátní adresa stojí 5 kreditů, které se účtují při vytvoření seznamu. Seznam s 10 000 adresami potřebuje 50 000 kreditů.
- Seznamy vždy používají režim `full`, který zahrnuje kontrolu schránky. Viz [Rychlý a úplný režim](/cs/docs/email-verification/single/#fast-and-full-mode).
- Pro API použijte API klíč s oprávněním **Full Access**.

## Vytvořte seznam

**Webové rozhraní**

  1. **Otevřete Lists.** Přejděte do **Email Verification → Lists** a vyberte **Verify emails**.

  2. **Pojmenujte seznam.** Do pole **Name** zadejte něco, co později poznáte, například `Newsletter import October`.

  3. **Přidejte adresy.** V poli **Input Method** zvolte jednu možnost:

     - **Enter emails manually:** vložte adresy do pole **Email Addresses**, oddělené čárkami, středníky nebo novými řádky.
     - **Upload a file:** vyberte soubor `.csv` nebo `.xlsx` menší než 10 MB. V CSV dejte na každý řádek jednu adresu, nebo je oddělte čárkami. V Excelu je dejte do prvního sloupce, jednu na řádek. Dialogové okno ukáže, kolik adres našlo.

  4. **Vyberte Create.** Emailit naúčtuje kredity a začne ověřovat.

**API**

  Zavolejte endpoint [Vytvoření seznamu k ověření](/cs/docs/api-reference/email-verifications/lists/create/) s názvem a polem adres:

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

  Odpověď `201` popisuje nový seznam:

```json
{
  "object": "email_verification_list",
  "id": "evl_3Rt8Wq5Lm2Kx",
  "name": "Newsletter import October",
  "status": "processing",
  "stats": {
    "total_emails": 3,
    "processed_emails": 0,
    "successful_verifications": 0,
    "failed_verifications": 0,
    "pending_emails": 3
  },
  "created_at": "2026-10-01T11:02:37Z",
  "updated_at": "2026-10-01T11:02:37Z",
  "valid_emails_count": 3,
  "unique_emails_count": 3,
  "invalid_emails_count": 0,
  "dispatched_jobs": 3
}
```

  | Stav | Kdy |
  | --- | --- |
  | `201` | Seznam se vytvořil a ověřování začalo. |
  | `400` | Chybí `name`, pole `emails` je prázdné, má víc než 10 000 položek, nebo žádná z nich nevypadá jako e-mailová adresa. |
  | `402` | Workspace nemá dost kreditů na všechny unikátní adresy. |

Před naúčtováním Emailit vstup vyčistí: všechny adresy převede na malá písmena, odstraní duplicity a vyřadí položky bez `@`. Účtují se vám jen unikátní adresy, které zbudou. Pokud se seznam nepodaří spustit, kredity se vrátí.

## Sledujte průběh

Stav seznamu prochází těmito fázemi:

| Stav | Význam |
| --- | --- |
| `pending` | Vytvořený, čeká na spuštění. |
| `processing` | Adresy se ověřují. |
| `completed` | Každá adresa má výsledek. |
| `failed` | Seznam se nepodařilo zpracovat. |
| `canceled` | Ověřování bylo zastaveno. |

V **Email Verification → Lists** ukazuje sloupec **Statistics** u každého seznamu počty **Total**, **Pending**, **Successful** a **Failed**. Sloupec **Expiring** ukazuje, kolik dní zbývá do smazání seznamu.

Přes API zavolejte endpoint [Načtení seznamu k ověření](/cs/docs/api-reference/email-verifications/lists/get/) a čtěte `status` a `stats`. Pokud se nechcete opakovaně dotazovat, přihlaste [webhook](/cs/docs/webhooks/set-up/) k odběru události `email_verification_list.updated`, která nastane po dokončení seznamu. Každá adresa navíc vyvolá `email_verification.updated`, jakmile je její výsledek hotový.

## Projděte výsledky

Výběrem seznamu ve webovém rozhraní ho otevřete. Stránka ukazuje:

- panely **Created**, **Status**, **Total Emails**, **Pending**, **Successful** a **Failed**,
- grafy **Verification Status Progress**, **Verification Results Breakdown** a **Risk Levels**,
- tabulku všech adres s jejich stavem, výsledkem, rizikem a skóre.

Přes API zavolejte endpoint [Výpis výsledků](/cs/docs/api-reference/email-verifications/lists/results/). Filtrujte podle `result` nebo `status` a stránkujte parametry `page` a `limit` (výchozí hodnota 50):

```bash
curl -G https://api.emailit.com/v2/email-verification-lists/evl_3Rt8Wq5Lm2Kx/results \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "result=invalid" \
  --data-urlencode "limit=100"
```

Každá položka obsahuje `id`, `email`, `status`, `result`, `score`, `risk` a `mx_records` adresy. Všechny hodnoty a co s nimi dělat vysvětluje stránka [Výsledky ověření](/cs/docs/email-verification/results/).

## Vyexportujte výsledky

Jakmile je seznam ve stavu `completed`, můžete si všechny jeho výsledky stáhnout jako soubor Excel.

**Webové rozhraní**

  Otevřete seznam a vyberte **Export Results**. Emailit stáhne soubor `.xlsx` pojmenovaný podle ID seznamu.

**API**

  Zavolejte endpoint [Export výsledků](/cs/docs/api-reference/email-verifications/lists/export/) a odpověď uložte:

```bash
curl https://api.emailit.com/v2/email-verification-lists/evl_3Rt8Wq5Lm2Kx/export \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -o results.xlsx
```

  Export seznamu, který není dokončený, vrací `400`.

Soubor má pro každou adresu jeden řádek s jejím stavem, výsledkem, skóre a rizikem, všemi jednotlivými kontrolami (platná syntaxe, jednorázová adresa, rolová adresa, plná schránka, doručitelnost, deaktivace, bezplatný e-mail, nesmyslná adresa, catch-all, připojení přes SMTP, MX záznamy), částmi adresy, stářím domény, návrhem `did_you_mean` a MX záznamy. Výsledky jsou barevně odlišené, takže je rychle přehlédnete.

> **Seznamy se mažou po 30 dnech:** Seznamy k ověření a jejich výsledky se mažou 30 dní po vytvoření. Pokud potřebujete výsledky uchovat déle, vyexportujte soubor.

## Využijte výsledky

1. **Odstraňte** adresy s výsledkem `invalid`, `disabled` nebo `disposable` před importem nebo odesláním.
2. **Zkontrolujte** adresy `inbox_full`, `role` a `unknown`. Pokud k tomu máte důvod, ponechte si je, ale sledujte jejich nedoručení.
3. **Naimportujte** zbytek do svých [kontaktů](/cs/docs/contacts/import-export/) nebo seznamu kontaktů.

Doporučený postup pro jednotlivé výsledky najdete v části [Doporučené akce](/cs/docs/email-verification/results/#recommended-actions).

## Související

  - [Výsledky ověření](/cs/docs/email-verification/results/): Všechny výsledky, úrovně rizika a kontroly.
  - [API seznamů k ověření](/cs/docs/api-reference/email-verifications/lists/): Vytvářejte seznamy a čtěte výsledky z kódu.

---
Zdroj: https://emailit.com/cs/docs/email-verification/lists/