> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enrow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# E-Mail finden

> Eine einzelne berufliche E-Mail-Adresse anhand eines vollständigen Namens und einer Unternehmensdomain oder eines Unternehmensnamens finden

<Badge color="green">POST</Badge>

```
https://api.enrow.io/email/find/single
```

Führen Sie eine einzelne E-Mail-Suche durch, um eine berufliche E-Mail-Adresse zu finden. Authentifizieren Sie jede Anfrage mit Ihrem [API-Schlüssel](/de/authentication) im `x-api-key`-Header. Für Batch-Operationen verwenden Sie den Endpunkt [E-Mails finden](/de/api-reference/email-finder/find-bulk) (bis zu 5.000 Suchen pro Batch).

<Info>
  Enrow führt **deterministische Verifizierungen** durch, die selbst Catch-all-E-Mails verifizieren. Das bedeutet, dass die gefundenen E-Mails danach nicht mehr durch einen Debouncer geleitet werden müssen.
</Info>

## Request Body

<ParamField body="fullname" type="string" required>
  Der vollständige Name der Person, für die die E-Mail gefunden werden soll
</ParamField>

<ParamField body="company_domain" type="string">
  Die Domain des Unternehmens, mehrere Formate werden akzeptiert (`"dundermifflin.com"`, `"https://www.dundermifflin.com"`...)

  **Hinweis**: Entweder `company_domain` oder `company_name` ist erforderlich.
</ParamField>

<ParamField body="company_name" type="string">
  Der Name des Unternehmens (`"Apple"`, `"Air France"`, ...)

  **Hinweis**: Entweder `company_domain` oder `company_name` ist erforderlich.
</ParamField>

<ParamField body="custom" type="object">
  Benutzerdefinierte Parameter, die in der GET-Antwort und in der Webhook-Benachrichtigung zurückgegeben werden.

  <Expandable title="custom-Objekt">
    <ParamField body="your_custom_key_name" type="string" default="your_custom_property">
      Ihre benutzerdefinierten Daten
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="settings" type="object">
  Eine Reihe von Einstellungen für diese Suche

  <Expandable title="settings-Eigenschaften">
    <ParamField body="webhook" type="string">
      Eine URL, die über eine HTTP-POST-Anfrage benachrichtigt wird, sobald die Einzelsuche abgeschlossen ist. Siehe [Wie Webhooks funktionieren](/de/how-webhooks-work).
    </ParamField>

    <ParamField body="country_code" type="string" default="US">
      Der ISO-3166-Alpha-2-Code des Landes, das mit der Suche zusammenhängt. Relevant bei Verwendung eines Unternehmensnamens — hilft, Homonyme durch die Suche auf einem lokalisierten Google zu unterscheiden.
    </ParamField>

    <ParamField body="retrieve_gender" type="boolean" default="false">
      Ermöglicht es Ihnen, das Geschlecht (`male`/`female`) der Person abzurufen.
    </ParamField>

    <ParamField body="retrieve_company_info" type="boolean" default="false">
      Gibt zusätzliche Unternehmensinformationen im Ergebnis zurück. Derzeit nur wirksam, wenn `country_code` gleich `FR` ist.
    </ParamField>
  </Expandable>
</ParamField>

## Response

### 200 — Suche gestartet

<ResponseField name="message" type="string">
  Bestätigungsnachricht
</ResponseField>

<ResponseField name="id" type="string">
  Eindeutige Kennung für diese Suche. Verwenden Sie sie, um Ergebnisse über den [GET-Endpunkt](/de/api-reference/email-finder/get-single-result) abzurufen.
</ResponseField>

<ResponseField name="credits_used" type="number">
  Anzahl der verbrauchten Credits. Siehe [Credits & Abrechnung](/de/credits-billing) für die Kosten pro Endpunkt.
</ResponseField>

### Error Responses

| Code    | Message                                                                                     |
| ------- | ------------------------------------------------------------------------------------------- |
| **400** | `invalid JSON input`                                                                        |
| **400** | `both company_domain and company_name are absent, input payload needs at least one of them` |
| **400** | `missing fullname`                                                                          |
| **401** | `No apikey found in the x-api-key headers`                                                  |
| **401** | `This apikey is not valid`                                                                  |
| **402** | `Insufficient credits`                                                                      |

<Note>
  Antworten bei unzureichendem Guthaben (`402`) auf Einzel-Endpunkten geben `{ "reason": "...", "success": false }` zurück; alle anderen Fehler geben `{ "message": "..." }` zurück.
</Note>

Siehe [Fehlerbehandlung](/de/error-handling) für die vollständige Liste der Statuscodes und Antwortformate.

<RequestExample>
  ```bash cURL theme={null}
  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
      }
    }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.enrow.io/email/find/single', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': process.env.ENROW_API_KEY
    },
    body: JSON.stringify({
      fullname: 'Dwight Schrute',
      company_domain: 'dundermifflin.com',
      settings: {
        retrieve_gender: true
      }
    })
  });

  const data = await response.json();
  console.log(data.id);
  ```

  ```python Python theme={null}
  import requests
  import os

  url = "https://api.enrow.io/email/find/single"
  headers = {
      "Content-Type": "application/json",
      "x-api-key": os.getenv("ENROW_API_KEY")
  }
  payload = {
      "fullname": "Dwight Schrute",
      "company_domain": "dundermifflin.com",
      "settings": {
          "retrieve_gender": True
      }
  }

  response = requests.post(url, json=payload, headers=headers)
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "message": "Single search operating",
    "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
    "credits_used": 1
  }
  ```

  ```json Error Response theme={null}
  {
    "message": "..."
  }
  ```
</ResponseExample>

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Ergebnis abrufen" icon="inbox" href="/de/api-reference/email-finder/get-single-result">
    Rufen Sie die gefundene E-Mail anhand der Such-`id` ab.
  </Card>

  <Card title="E-Mails per Batch finden" icon="layer-group" href="/de/api-reference/email-finder/find-bulk">
    Führen Sie bis zu 5.000 E-Mail-Suchen in einer einzigen Anfrage durch.
  </Card>

  <Card title="Authentifizierung" icon="key" href="/de/authentication">
    So übergeben Sie Ihren API-Schlüssel im x-api-key-Header.
  </Card>

  <Card title="Webhooks" icon="bell" href="/de/how-webhooks-work">
    Werden Sie automatisch benachrichtigt, wenn eine Suche abgeschlossen ist.
  </Card>
</CardGroup>