> ## 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.

# Statuscodes

> Referenz für die HTTP-Statuscodes und Suchqualifikationswerte der Enrow-API, damit Sie wissen, wie Sie jede Antwort verarbeiten

Die Enrow-API verwendet standardmäßige HTTP-Statuscodes, um das Ergebnis jeder Anfrage anzuzeigen, sowie ein `qualification`-Feld, das Ihnen das Ergebnis einer Suche oder Verifizierung mitteilt. Diese Seite listet jeden Code und jeden Qualifikationswert auf, damit Sie Antworten zuverlässig verarbeiten können. Die passenden Fehlermeldungen und Antwortformate finden Sie unter [Fehlerbehandlung](/de/error-handling).

## Welche HTTP-Statuscodes gibt die API zurück?

Die Enrow-API verwendet standardmäßige HTTP-Statuscodes, um das Ergebnis jeder Anfrage anzuzeigen. Ein `2xx`-Code bedeutet, dass die Anfrage erfolgreich war, ein `4xx`-Code weist auf ein Problem mit der Anfrage hin, und ein `5xx`-Code bedeutet, dass auf Seiten von Enrow etwas schiefgelaufen ist.

### Welche Codes bedeuten Erfolg?

Ein `2xx`-Statuscode bedeutet, dass die API die Anfrage angenommen hat. Asynchrone Vorgänge (etwa Massensuchen) geben `201` oder `202` zurück, da die Verarbeitung im Hintergrund weiterläuft.

| Code    | Bedeutung | Beschreibung                                     |
| ------- | --------- | ------------------------------------------------ |
| **200** | OK        | Anfrage erfolgreich, Ergebnisse zurückgegeben    |
| **201** | Created   | Ressource erstellt (z. B. Massensuche gestartet) |
| **202** | Accepted  | Anfrage angenommen, asynchrone Verarbeitung      |

### Welche Codes bedeuten, dass die Anfrage abgelehnt wurde?

Ein `4xx`-Statuscode bedeutet, dass die API die Anfrage aufgrund eines Problems abgelehnt hat, das auf der Client-Seite behoben werden kann – ungültige Parameter, ein fehlender oder ungültiger API-Schlüssel, unzureichende Credits oder zu viele Anfragen.

| Code    | Bedeutung         | Beschreibung                            |
| ------- | ----------------- | --------------------------------------- |
| **400** | Bad Request       | Ungültige oder fehlende Parameter       |
| **401** | Unauthorized      | Ungültiger oder fehlender API-Schlüssel |
| **402** | Payment Required  | Unzureichende Credits                   |
| **429** | Too Many Requests | Ratenlimit überschritten                |

Ein `401` bedeutet, dass der API-Schlüssel fehlt oder ungültig ist – unter [Authentifizierung](/de/authentication) erfahren Sie, wie Sie ihn korrekt übergeben. Ein `402` bedeutet, dass das Konto keine Credits mehr hat; prüfen Sie den Verbrauch unter [Credits & Abrechnung](/de/credits-billing). Ein `429` bedeutet, dass die Anfrage den zulässigen Durchsatz überschritten hat – unter [Ratenlimits](/de/rate-limits) erfahren Sie mehr über die Schwellenwerte.

<Note>
  Die API gibt niemals **404** zurück. Eine unbekannte oder abgelaufene Such-ID liefert bei Massen-Endpunkten **400** und bei Einzel-Endpunkten **500**.
</Note>

### Welche Codes bedeuten einen Serverfehler?

Ein `5xx`-Statuscode bedeutet, dass die Anfrage gültig war, aber auf Seiten von Enrow etwas schiefgelaufen ist. Diese Antworten können nach einer kurzen Verzögerung gefahrlos erneut versucht werden.

| Code    | Bedeutung             | Beschreibung                               |
| ------- | --------------------- | ------------------------------------------ |
| **500** | Internal Server Error | Auf unserer Seite ist etwas schiefgelaufen |

## Was sind Suchqualifikationen?

Eine Suchqualifikation ist der Wert im `qualification`-Feld, der Ihnen das Ergebnis einer Suche oder Verifizierung mitteilt. Enrow gibt dieses Feld über alle Endpunkte hinweg zurück, und das Ergebnis ist immer **binär** – es gibt kein „vielleicht“ und keinen Wahrscheinlichkeitswert. Dies ist eine bewusste Designentscheidung.

### Warum ist das Ergebnis binär?

Das Ergebnis ist binär, weil eine klare Ja-oder-Nein-Antwort leichter umzusetzen ist als eine Wahrscheinlichkeit. Die meisten Anreicherungstools geben einen komplexen Satz von Kategorien zurück – catch-all, riskant, unbekannt, nicht verifizierbar usw. –, die Sie zwingen, Logik rund um Wahrscheinlichkeiten aufzubauen. Enrow hat den entgegengesetzten Ansatz gewählt:

* **Enrow verifiziert selbst Catch-all-E-Mails deterministisch**, sodass keine „catch-all“-Kategorie nötig ist
* Enrow glaubt nicht an probabilistische Systeme mit Dutzenden von Klassifizierungen – sie schaffen Komplexität ohne Klarheit
* Ein binäres Ergebnis bedeutet, dass Sie sofort auf die Daten reagieren können, ohne sie zu hinterfragen

Das Ergebnis ist entweder gut oder nicht. Einfach.

### Welche Qualifikationen gibt der Email Finder zurück?

Der [Email Finder](/de/api-reference/email-finder/find-single) gibt einen der folgenden Werte im `qualification`-Feld zurück:

| Qualifikation | Bedeutung                       |
| ------------- | ------------------------------- |
| `valid`       | E-Mail gefunden und verifiziert |
| `invalid`     | E-Mail nicht gefunden           |
| `ongoing`     | Suche noch in Bearbeitung       |

### Welche Qualifikationen gibt der Email Verifier zurück?

Der [Email Verifier](/de/api-reference/email-verifier/verify-single) gibt einen der folgenden Werte im `qualification`-Feld zurück:

| Qualifikation | Bedeutung                                 |
| ------------- | ----------------------------------------- |
| `valid`       | E-Mail ist gültig und zustellbar          |
| `invalid`     | E-Mail ist ungültig oder nicht zustellbar |
| `ongoing`     | Verifizierung noch in Bearbeitung         |

<Note>
  `invalid` bedeutet je nach Endpunkt Unterschiedliches: Beim **Email Finder** bedeutet es, dass die E-Mail nicht gefunden wurde. Beim **Email Verifier** bedeutet es, dass die E-Mail existiert, aber nicht zustellbar ist.
</Note>

### Welche Qualifikationen gibt der Phone Finder zurück?

Der [Phone Finder](/de/api-reference/phone/find-single) gibt einen der folgenden Werte im `qualification`-Feld zurück:

| Qualifikation | Bedeutung                                  |
| ------------- | ------------------------------------------ |
| `found`       | Telefonnummer erfolgreich ermittelt        |
| `not_found`   | Telefonnummer konnte nicht gefunden werden |
| `ongoing`     | Suche noch in Bearbeitung                  |

### Wie verfolge ich eine Massensuche?

Bei Massenvorgängen zeigt ein `status`-Feld den Fortschritt des Batches an. Fragen Sie den entsprechenden GET-Endpunkt ab – [Massenergebnisse des Email Finders](/de/api-reference/email-finder/get-bulk-results), [Massenverifizierungen des Email Verifiers](/de/api-reference/email-verifier/get-bulk-verifications) oder [Massenergebnisse des Phone Finders](/de/api-reference/phone/get-bulk-results) –, bis der `status` auf `completed` steht.

| Status      | Bedeutung                               |
| ----------- | --------------------------------------- |
| `ongoing`   | Batch wird noch verarbeitet             |
| `completed` | Alle Suchen im Batch sind abgeschlossen |
| `failed`    | Der Batch ist fehlgeschlagen            |

## FAQ

<AccordionGroup>
  <Accordion title="Warum erhalte ich ein 401 statt eines 200?">
    Ein `401 Unauthorized` bedeutet, dass der API-Schlüssel fehlt oder ungültig ist. Stellen Sie sicher, dass jede Anfrage einen gültigen Schlüssel im `x-api-key`-Header enthält. Weitere Informationen finden Sie unter [Authentifizierung](/de/authentication).
  </Accordion>

  <Accordion title="Was bedeutet ein 402-Statuscode?">
    Ein `402 Payment Required` bedeutet, dass das Konto nicht genügend Credits hat, um die Anfrage abzuschließen. Laden Sie Ihr Guthaben auf oder prüfen Sie unter [Credits & Abrechnung](/de/credits-billing), wie Credits pro Endpunkt verbraucht werden.
  </Accordion>

  <Accordion title="Warum gibt eine unbekannte Such-ID 400 oder 500 statt 404 zurück?">
    Die Enrow-API gibt niemals `404` zurück. Eine unbekannte oder abgelaufene Such-ID liefert bei Massen-Endpunkten `400` und bei Einzel-Endpunkten `500`. Überprüfen Sie die `id`, die beim Start der Suche zurückgegeben wurde.
  </Accordion>

  <Accordion title="Bedeutet qualification: ongoing, dass etwas fehlgeschlagen ist?">
    Nein. `ongoing` bedeutet, dass die Suche oder Verifizierung noch in Bearbeitung ist. Fragen Sie den GET-Endpunkt nach einer kurzen Verzögerung erneut ab, oder verwenden Sie einen Webhook, um automatisch benachrichtigt zu werden, wenn der Vorgang abgeschlossen ist – siehe [So funktionieren Webhooks](/de/how-webhooks-work).
  </Accordion>
</AccordionGroup>

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Fehlerbehandlung" icon="triangle-exclamation" href="/de/error-handling">
    Sehen Sie die vollständigen Fehlermeldungen und Antwortformate für jeden Statuscode.
  </Card>

  <Card title="Authentifizierung" icon="key" href="/de/authentication">
    Übergeben Sie Ihren API-Schlüssel im x-api-key-Header, um 401-Fehler zu vermeiden.
  </Card>

  <Card title="Ratenlimits" icon="gauge-high" href="/de/rate-limits">
    Verstehen Sie die Schwellenwerte, die eine 429-Antwort auslösen.
  </Card>

  <Card title="Credits & Abrechnung" icon="coins" href="/de/credits-billing">
    Sehen Sie, wie Credits verbraucht werden, und vermeiden Sie 402-Fehler.
  </Card>
</CardGroup>
