Passer au contenu principal
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}
Récupérez tous les résultats d’une recherche d’emails groupée à l’aide de l’ID du lot. Authentifiez chaque requête avec votre clé API dans l’en-tête x-api-key. L’ID du lot est l’id renvoyé lorsque vous lancez une tâche avec l’endpoint Find Bulk Emails.
L’utilisation d’un webhook vous permet d’éviter d’appeler cet endpoint GET. Voir Fonctionnement des webhooks.

​
Paramètres de requête

​
id
string
requis
L’id renvoyé par la requête POST

​
Réponse

​
200 — Recherche terminée

​
general
object
Métadonnées du lot
​
stats
object
Statistiques du lot
​
results
array
Tableau des résultats de recherche

​
200 — Recherche encore en cours

Pendant l’exécution du lot, l’endpoint GET renvoie un statut HTTP 200 avec un corps réduit de la forme { general: { id, status: "ongoing" }, stats: { finished, requested } }.
​
general
object
id et status: "ongoing"
​
stats
object
Compteurs finished et requested

​
Réponses d’erreur

CodeMessage
400Could not retrieve bulk search results
Consultez Gestion des erreurs pour la liste complète des codes de statut et des formats de réponse. 
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"
    }
  ]
}

​
Étapes suivantes

Rechercher des emails en masse

Lancez un nouveau lot pouvant compter jusqu’à 5 000 recherches d’emails.

Webhooks

Évitez le polling et soyez notifié dès qu’un lot est terminé.

Crédits et facturation

Découvrez comment les crédits sont débités et remboursés par résultat.

Vérifier des emails en masse

Validez une liste d’adresses email en un seul lot.