Vai al contenuto principale
GET
/
email
/
verify
/
bulk
curl --request GET \
  --url 'https://api.enrow.io/email/verify/bulk?id=9d4fa0ed-f76b-409f-bee4-d5468ebda70e' \
  --header 'x-api-key: YOUR_API_KEY'
{
  "general": {
    "id": "9d4fa0ed-f76b-409f-bee4-d5468ebda70e",
    "status": "completed"
  },
  "results": [
    {
      "email": "pam.beesly@dundermifflin.com",
      "index": "195f87c6-376e-4eca-9861-f92935413b0c",
      "qualification": "valid"
    },
    {
      "email": "angela.martin@dundermifflin.com",
      "index": "662784ae-3722-47af-b056-7554e013f73b",
      "qualification": "valid"
    }
  ],
  "stats": {
    "credits_cost": 0.5,
    "requested": 2,
    "valid": 2
  }
}
GET
https://api.enrow.io/email/verify/bulk?id={id}
Recupera tutti i risultati di una verifica di email in blocco utilizzando l’ID del batch. Autentica ogni richiesta con la tua chiave API nell’header x-api-key. Per avviare prima un batch, utilizza l’endpoint Verify Bulk Emails.
L’utilizzo di un webhook ti consente di evitare la chiamata a questo endpoint GET. Vedi How Webhooks Work.

Parametri di query

id
string
obbligatorio
L’id restituito dalla richiesta POST

Risposta

200 — Verifica completata

general
object
Metadati del batch
stats
object
Statistiche del batch
results
array
Array dei risultati della verifica

200 — Verifica ancora in corso

Mentre il batch è ancora in esecuzione, l’endpoint restituisce HTTP 200 con lo stato del batch anziché i risultati completi.
general
object
Metadati del batch
stats
object
Avanzamento del batch

Risposte di errore

CodiceMessaggio
400Could not retrieve bulk verification results
Vedi Gestione degli errori per l’elenco completo dei codici di stato e dei formati di risposta.
curl --request GET \
  --url 'https://api.enrow.io/email/verify/bulk?id=9d4fa0ed-f76b-409f-bee4-d5468ebda70e' \
  --header 'x-api-key: YOUR_API_KEY'
{
  "general": {
    "id": "9d4fa0ed-f76b-409f-bee4-d5468ebda70e",
    "status": "completed"
  },
  "results": [
    {
      "email": "pam.beesly@dundermifflin.com",
      "index": "195f87c6-376e-4eca-9861-f92935413b0c",
      "qualification": "valid"
    },
    {
      "email": "angela.martin@dundermifflin.com",
      "index": "662784ae-3722-47af-b056-7554e013f73b",
      "qualification": "valid"
    }
  ],
  "stats": {
    "credits_cost": 0.5,
    "requested": 2,
    "valid": 2
  }
}

Passaggi successivi

Verifica email in blocco

Avvia una verifica batch e ottieni l’id del batch.

Verifica una singola email

Controlla se un singolo indirizzo email è valido e recapitabile.

Webhooks

Ricevi una notifica automatica al completamento di un batch invece di effettuare polling.

Crediti e fatturazione

Scopri come vengono consumati i crediti per ciascun endpoint.