Naar hoofdinhoud gaan
POST
/
email
/
find
/
single
curl --request POST \
  --url https://api.enrow.io/email/find/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "fullname": "Dwight Schrute",
    "company_domain": "dundermifflin.com",
    "settings": {
      "retrieve_gender": true
    }
  }'

{
  "message": "Single search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 1
}
POST 
https://api.enrow.io/email/find/single
Voer één e-mailzoekopdracht uit om een professioneel e-mailadres te vinden. Authenticeer elk verzoek met je API-sleutel in de x-api-key-header. Gebruik voor batchbewerkingen het Find Bulk Emails-endpoint (tot 5.000 zoekopdrachten per batch).
Enrow voert deterministische verificaties uit die zelfs catch-all-e-mails verifiëren. Dit betekent dat het achteraf door een debouncer halen van de gevonden e-mails niet nodig is.

​
Request Body

​
fullname
string
vereist
De volledige naam van de persoon voor wie het e-mailadres moet worden gevonden
​
company_domain
string
Het domein van het bedrijf, meerdere formaten worden geaccepteerd ("dundermifflin.com", "https://www.dundermifflin.com"…)Opmerking: Ofwel company_domain ofwel company_name is vereist.
​
company_name
string
De naam van het bedrijf ("Apple", "Air France", …)Opmerking: Ofwel company_domain ofwel company_name is vereist.
​
custom
object
Aangepaste parameters die worden teruggegeven in de GET-respons en in de webhook-notificatie.
​
settings
object
Een set instellingen die betrekking heeft op deze zoekopdracht

​
Response

​
200 — Zoekopdracht gestart

​
message
string
Bevestigingsbericht
​
id
string
Unieke identificator voor deze zoekopdracht. Gebruik deze om resultaten op te halen via het GET endpoint.
​
credits_used
number
Aantal verbruikte credits. Zie Credits & billing voor de kosten per endpoint.

​
Foutresponsen

CodeMessage
400invalid JSON input
400both company_domain and company_name are absent, input payload needs at least one of them
400missing fullname
401No apikey found in the x-api-key headers
401This apikey is not valid
402Insufficient credits
Responsen met onvoldoende credits (402) op enkele endpoints geven { "reason": "...", "success": false } terug; alle andere fouten geven { "message": "..." } terug.
Zie Error handling voor de volledige lijst met statuscodes en responsformaten. 
curl --request POST \
  --url https://api.enrow.io/email/find/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "fullname": "Dwight Schrute",
    "company_domain": "dundermifflin.com",
    "settings": {
      "retrieve_gender": true
    }
  }'

{
  "message": "Single search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 1
}

​
Volgende stappen

Het resultaat ophalen

Haal de gevonden e-mail op met de id van de zoekopdracht.

E-mails in bulk vinden

Voer tot 5.000 e-mailzoekopdrachten uit in één verzoek.

Authenticatie

Hoe je je API-sleutel doorgeeft in de x-api-key-header.

Webhooks

Word automatisch genotificeerd wanneer een zoekopdracht is voltooid.