Vai al contenuto principale
GET
/
email
/
find
/
bulk
curl --request GET \
  --url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
  --header 'x-api-key: YOUR_API_KEY'

{
  "general": {
    "id": "3d4cb64e-i64d-41e8-a686-736751004a32",
    "status": "completed",
    "custom": "campaign_q2"
  },
  "stats": {
    "finished": 3,
    "requested": 3,
    "valid": 2,
    "credits_cost": {
      "initial": 3,
      "refunded": 1,
      "final": 2
    }
  },
  "results": [
    {
      "index": "0",
      "qualification": "valid",
      "email": "dwight.schrute@dundermifflin.com",
      "info": {
        "domain": "dundermifflin.com",
        "firstname": "Dwight",
        "lastname": "Schrute",
        "companyInfo": {
          "name": "Dunder Mifflin"
        }
      },
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Dwight Schrute"
      },
      "custom": "lead_001"
    },
    {
      "index": "1",
      "qualification": "valid",
      "email": "jim.halpert@dundermifflin.com",
      "info": {
        "domain": "dundermifflin.com",
        "firstname": "Jim",
        "lastname": "Halpert",
        "companyInfo": {
          "name": "Dunder Mifflin"
        }
      },
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Jim Halpert"
      },
      "custom": "lead_002"
    },
    {
      "index": "2",
      "qualification": "invalid",
      "email": null,
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Ryan Howard"
      },
      "custom": "lead_003"
    }
  ]
}
GET 
https://api.enrow.io/email/find/bulk?id={id}
Recupera tutti i risultati di una ricerca email in blocco utilizzando l’ID del batch. Autentica ogni richiesta con la tua chiave API nell’header x-api-key. L’ID del batch è l’id restituito all’avvio di un processo con l’endpoint Find Bulk Emails.
L’utilizzo di un webhook ti consente di evitare di chiamare questo endpoint GET. Consulta How Webhooks Work.

​
Parametri di query

​
id
string
obbligatorio
L’id restituito dalla richiesta POST

​
Risposta

​
200 — Ricerca completata

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

​
200 — Ricerca ancora in corso

Mentre il batch è in esecuzione, l’endpoint GET restituisce HTTP 200 con un corpo ridotto della forma { general: { id, status: "ongoing" }, stats: { finished, requested } }.
​
general
object
id e status: "ongoing"
​
stats
object
Conteggi di finished e requested

​
Risposte di errore

CodiceMessaggio
400Could not retrieve bulk search results
Consulta Error handling per l’elenco completo dei codici di stato e dei formati di risposta. 
curl --request GET \
  --url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
  --header 'x-api-key: YOUR_API_KEY'

{
  "general": {
    "id": "3d4cb64e-i64d-41e8-a686-736751004a32",
    "status": "completed",
    "custom": "campaign_q2"
  },
  "stats": {
    "finished": 3,
    "requested": 3,
    "valid": 2,
    "credits_cost": {
      "initial": 3,
      "refunded": 1,
      "final": 2
    }
  },
  "results": [
    {
      "index": "0",
      "qualification": "valid",
      "email": "dwight.schrute@dundermifflin.com",
      "info": {
        "domain": "dundermifflin.com",
        "firstname": "Dwight",
        "lastname": "Schrute",
        "companyInfo": {
          "name": "Dunder Mifflin"
        }
      },
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Dwight Schrute"
      },
      "custom": "lead_001"
    },
    {
      "index": "1",
      "qualification": "valid",
      "email": "jim.halpert@dundermifflin.com",
      "info": {
        "domain": "dundermifflin.com",
        "firstname": "Jim",
        "lastname": "Halpert",
        "companyInfo": {
          "name": "Dunder Mifflin"
        }
      },
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Jim Halpert"
      },
      "custom": "lead_002"
    },
    {
      "index": "2",
      "qualification": "invalid",
      "email": null,
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Ryan Howard"
      },
      "custom": "lead_003"
    }
  ]
}

​
Passaggi successivi

Trova email in blocco

Avvia un nuovo batch di un massimo di 5.000 ricerche email.

Webhook

Evita il polling e ricevi una notifica al completamento di un batch.

Crediti e fatturazione

Scopri come i crediti vengono addebitati e rimborsati per ogni risultato.

Verifica email in blocco

Convalida un elenco di indirizzi email in un unico batch.