Události seznamů k ověření
Vytvořené a dokončené seznamy k ověření.
email_verification_list.created
Odesílá se, když vytvoříte seznam přes endpoint Vytvoření seznamu k ověření. Ověřování už začalo, takže status má hodnotu processing a stats obsahuje počáteční hodnoty.
Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.
Pole
event_idstringID události (evt_…). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint Načtení události.
typestringVždy email_verification_list.created.
objectobjectSeznam k ověření, kterého se událost týká. Jeho pole jsou uvedena níže.
data.objectobjectStejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.
Objekt seznamu k ověření
idstringID seznamu (evl_…).
objectstringVždy email_verification_list.
namestringNázev seznamu.
statusstringprocessing u události email_verification_list.created, completed u události email_verification_list.updated.
statsobjectPočty: total_emails, processed_emails, successful_verifications, failed_verifications a pending_emails a k tomu results s dokončenými adresami podle výsledku. Viz Statistiky.
created_atstringKdy byl seznam vytvořen, ve formátu ISO 8601 s posunem vůči UTC.
updated_atstringKdy byl seznam naposledy upraven.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "email_verification_list.created",
"object": {
"id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
"object": "email_verification_list",
"name": "October newsletter import",
"status": "processing",
"stats": {
"total_emails": 1000,
"processed_emails": 0,
"successful_verifications": 0,
"failed_verifications": 0,
"pending_emails": 1000,
"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",
"updated_at": "2026-10-01T10:30:02.502000+00:00"
},
"data": {
"object": {
"id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
"object": "email_verification_list",
"name": "October newsletter import",
"status": "processing",
"stats": {
"total_emails": 1000,
"processed_emails": 0,
"successful_verifications": 0,
"failed_verifications": 0,
"pending_emails": 1000,
"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",
"updated_at": "2026-10-01T10:30:02.502000+00:00"
}
}
}email_verification_list.updated
Odesílá se, když má každá adresa ze seznamu k ověření konečný výsledek a stav seznamu se změní na completed. Pole stats obsahuje konečné počty a stats.results počet adres s jednotlivými výsledky. Výsledky si přečtěte přes endpoint Výpis výsledků, nebo je stáhněte přes Export výsledků.
Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.
Pole
event_idstringID události (evt_…). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint Načtení události.
typestringVždy email_verification_list.updated.
objectobjectSeznam k ověření, kterého se událost týká. Jeho pole jsou uvedena níže.
data.objectobjectStejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.
Objekt seznamu k ověření
idstringID seznamu (evl_…).
objectstringVždy email_verification_list.
namestringNázev seznamu.
statusstringprocessing u události email_verification_list.created, completed u události email_verification_list.updated.
statsobjectPočty: total_emails, processed_emails, successful_verifications, failed_verifications a pending_emails a k tomu results s dokončenými adresami podle výsledku. Viz Statistiky.
created_atstringKdy byl seznam vytvořen, ve formátu ISO 8601 s posunem vůči UTC.
updated_atstringKdy byl seznam naposledy upraven.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "email_verification_list.updated",
"object": {
"id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
"object": "email_verification_list",
"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"
},
"data": {
"object": {
"id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
"object": "email_verification_list",
"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"
}
}
}