Vai al contenuto
Docs

Verifica fino a 10.000 indirizzi alla volta ed esporta gli esiti.

URL di basehttps://api.emailit.com/v2AutenticazioneErroriLimiti di frequenza

Crea una lista

Crea una lista di verifica e avvia in background la verifica dei suoi indirizzi. Ogni indirizzo viene controllato in modalità full, compreso il controllo della casella descritto in Verifica un indirizzo. Richiede una chiave API con il permesso full.

POST/email-verification-lists

Corpo della richiesta

namestringObbligatorio

Nome della lista, da 1 a 255 caratteri.

emailsstring[]Obbligatorio

Indirizzi da verificare, da 1 a 10.000. Ogni elemento deve essere un indirizzo email valido. Emailit rimuove gli spazi, li converte in minuscolo e rimuove i duplicati.

Restituisce

Restituisce 201 Created con la lista. Emailit addebita 5 crediti per ogni indirizzo univoco prima che inizi la verifica. La risposta indica quanti indirizzi sono stati accettati (valid_emails_count, unique_emails_count) e quanti job di verifica sono stati messi in coda (dispatched_jobs). La nuova lista ha lo stato processing.

stats viene aggiornato man mano che ogni indirizzo viene completato. Quando ogni indirizzo ha un esito definitivo, la lista passa a completed. Interroga periodicamente Recupera una lista o ascolta gli eventi webhook:

Stato Quando
400 name o emails manca o è vuoto, emails ha più di 10.000 elementi, oppure un elemento non è un indirizzo valido (errore di convalida standard).
402 Il workspace non ha crediti sufficienti per tutti gli indirizzi univoci.

Statistiche

Campo Descrizione
total_emails Indirizzi univoci nella lista.
processed_emails Indirizzi completati, con un esito o con un errore.
successful_verifications Indirizzi con un esito definitivo, qualunque esso sia. Non significa che gli indirizzi siano validi; vedi results.
failed_verifications Indirizzi che un errore ha impedito a Emailit di controllare.
pending_emails Indirizzi non ancora completati, compresi quelli in attesa di un nuovo tentativo dopo il greylisting.
results Indirizzi completati per esito: safe, role, catch_all, unknown, inbox_full, disabled, disposable e invalid. Le liste meno recenti potrebbero non averlo.
POST/email-verification-lists
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,
    "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"
}

Elenca le liste

Restituisce le liste di verifica email, a partire dalla più recente. Richiede una chiave API full.

GET/email-verification-lists

Parametri di query

pageinteger

Numero della pagina, a partire da 1. Valore predefinito: 1.

limitinteger

Liste per pagina, da 1 a 100. Valore predefinito: 10.

statusstring

Solo le liste con questo stato: pending, processing, completed, failed o canceled.

searchstring

Corrispondenza sul nome della lista, senza distinzione tra maiuscole e minuscole.

matchstring

all (predefinito) richiede che corrispondano tutti i filtri. or richiede che ne corrisponda almeno uno. Vedi Filtri e ordinamento.

orderstring

Chiave di ordinamento di questo elenco. Vedi le chiavi di ordinamento qui sotto.

directionstring

asc o desc.

Filtri e ordinamento

I filtri degli elenchi sono un unico livello di parametri di query key.condition=value. Vedi Filtri e ordinamento per match, order, direction e l’elenco delle condizioni per tipo.

Chiavi di filtro

ChiaveTipoCondizioniNote
namestringexact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
statusstringexact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
created_atdateexact, before, after, empty, not_empty

Chiavi di ordinamento

Passa in order una di queste chiavi e in direction il valore asc o desc: name, status, created_at

Restituisce

Restituisce 200 OK con le liste in data, più next_page_url e previous_page_url (null alle due estremità). Ogni lista ha id, name, status, stats, created_at e updated_at; per i campi di stats, vedi Crea una lista.

GET/email-verification-lists
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,
        "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
}

Recupera una lista

Restituisce una lista di verifica email. Interrogala periodicamente per sapere quando una lista è completed, oppure ascolta l’evento webhook email_verification_list.updated. Richiede una chiave API full.

GET/email-verification-lists/:id

Parametri di percorso

idstringObbligatorio

ID della lista, ad esempio evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.

Restituisce

Restituisce 200 OK con id, name, status, stats, created_at e updated_at della lista. stats viene aggiornato man mano che ogni indirizzo viene completato, quindi puoi seguire l’avanzamento di una lista processing. Per i campi di stats, vedi Crea una lista.

Restituisce 404 se la lista non esiste nel workspace.

GET/email-verification-lists/{id}
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,
    "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"
}

Elenca gli esiti

Restituisce un esito per ogni indirizzo di una lista di verifica, a partire da quello aggiornato più di recente. Gli esiti compaiono man mano che gli indirizzi vengono completati, quindi puoi leggerli prima che l’intera lista sia terminata. Richiede una chiave API full.

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

Parametri di percorso

idstringObbligatorio

ID della lista, ad esempio evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.

Parametri di query

pageinteger

Numero della pagina, a partire da 1. Valore predefinito: 1.

limitinteger

Esiti per pagina, da 1 a 100. Valore predefinito: 50.

statusstring

Solo gli esiti con questo stato: pending, processing, completed, failed o canceled.

resultstring

Solo gli esiti con questo risultato: safe, role, catch_all, unknown, inbox_full, disabled, disposable o invalid.

matchstring

all (predefinito) richiede che corrispondano tutti i filtri. or richiede che ne corrisponda almeno uno. Vedi Filtri e ordinamento.

orderstring

Chiave di ordinamento di questo elenco. Vedi le chiavi di ordinamento qui sotto.

directionstring

asc o desc.

Filtri e ordinamento

I filtri degli elenchi sono un unico livello di parametri di query key.condition=value. Vedi Filtri e ordinamento per match, order, direction e l’elenco delle condizioni per tipo.

Chiavi di filtro

ChiaveTipoCondizioniNote
emailstringexact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
statusstringexact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
resultstringexact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
riskstringexact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
created_atdateexact, before, after, empty, not_empty

Chiavi di ordinamento

Passa in order una di queste chiavi e in direction il valore asc o desc: email, status, result, risk, created_at

Restituisce

Restituisce 200 OK con gli esiti in data, più next_page_url e previous_page_url (null alle due estremità). Ogni esito è un oggetto email_verification con gli stessi campi restituiti da Verifica un indirizzo: id (evr_…), email, status, result, score, risk, mode, checks, address, did_you_mean, mx_records e i timestamp. Un indirizzo ancora pending o processing non ha ancora un esito definitivo. Uno interrotto da un errore ha lo stato failed e l’esito error; puoi trovarli con status=failed.

Restituisce 404 se la lista non esiste nel workspace.

GET/email-verification-lists/{id}/results
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": "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
}

Esporta gli esiti

Scarica gli esiti di una lista di verifica come foglio di calcolo XLSX. Prima la lista deve essere completed. Richiede una chiave API con il permesso full.

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

Parametri di percorso

idstringObbligatorio

ID della lista, ad esempio evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.

Restituisce

Restituisce 200 OK con il file come corpo della risposta, Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet e un header Content-Disposition: attachment. Il file prende il nome dall’ID della lista, ad esempio evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.xlsx.

Stato Quando
400 La lista non è ancora completed.
404 La lista non esiste nel workspace, oppure non ha esiti da esportare.
GET/email-verification-lists/{id}/export
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>

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.