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

> Referentie voor de HTTP-statuscodes en zoekkwalificatiewaarden van de Enrow API, zodat je weet hoe je elke respons moet afhandelen

De Enrow API gebruikt standaard HTTP-statuscodes om de uitkomst van elk verzoek aan te geven, plus een `qualification`-veld dat je het resultaat van een zoekopdracht of verificatie vertelt. Deze pagina vermeldt elke code en kwalificatiewaarde, zodat je responsen betrouwbaar kunt afhandelen. Voor de bijbehorende foutmeldingen en responsformaten, zie [Foutafhandeling](/nl/error-handling).

## Welke HTTP-statuscodes retourneert de API?

De Enrow API gebruikt standaard HTTP-statuscodes om het resultaat van elk verzoek aan te geven. Een `2xx`-code betekent dat het verzoek is geslaagd, een `4xx`-code wijst op een probleem met het verzoek, en een `5xx`-code betekent dat er iets is misgegaan aan de kant van Enrow.

### Welke codes betekenen succes?

Een `2xx`-statuscode betekent dat de API het verzoek heeft geaccepteerd. Asynchrone bewerkingen (zoals bulkzoekopdrachten) retourneren `201` of `202` omdat het werk op de achtergrond doorloopt.

| Code    | Betekenis | Beschrijving                                         |
| ------- | --------- | ---------------------------------------------------- |
| **200** | OK        | Verzoek geslaagd, resultaten geretourneerd           |
| **201** | Created   | Resource aangemaakt (bijv. bulkzoekopdracht gestart) |
| **202** | Accepted  | Verzoek geaccepteerd, asynchrone verwerking          |

### Welke codes betekenen dat het verzoek is geweigerd?

Een `4xx`-statuscode betekent dat de API het verzoek heeft geweigerd vanwege iets dat aan de clientzijde kan worden opgelost — ongeldige parameters, een ontbrekende of ongeldige API-sleutel, onvoldoende credits, of te veel verzoeken.

| Code    | Betekenis         | Beschrijving                         |
| ------- | ----------------- | ------------------------------------ |
| **400** | Bad Request       | Ongeldige of ontbrekende parameters  |
| **401** | Unauthorized      | Ongeldige of ontbrekende API-sleutel |
| **402** | Payment Required  | Onvoldoende credits                  |
| **429** | Too Many Requests | Rate limit overschreden              |

Een `401` betekent dat de API-sleutel ontbreekt of ongeldig is — zie [Authenticatie](/nl/authentication) voor hoe je deze correct meegeeft. Een `402` betekent dat het account geen credits meer heeft; bekijk het verbruik in [Credits en facturatie](/nl/credits-billing). Een `429` betekent dat het verzoek de toegestane doorvoer heeft overschreden — zie [Rate limits](/nl/rate-limits) om de drempelwaarden te begrijpen.

<Note>
  De API retourneert nooit **404**. Een onbekend of verlopen zoek-ID retourneert **400** voor bulk-endpoints en **500** voor enkelvoudige endpoints.
</Note>

### Welke codes betekenen een serverfout?

Een `5xx`-statuscode betekent dat het verzoek geldig was, maar dat er iets is misgegaan aan de kant van Enrow. Deze responsen kun je veilig opnieuw proberen na een korte vertraging.

| Code    | Betekenis             | Beschrijving                       |
| ------- | --------------------- | ---------------------------------- |
| **500** | Internal Server Error | Er is iets misgegaan aan onze kant |

## Wat zijn zoekkwalificaties?

Een zoekkwalificatie is de waarde in het `qualification`-veld die je de uitkomst van een zoekopdracht of verificatie vertelt. Enrow retourneert dit veld in alle endpoints, en het resultaat is altijd **binair** — er is geen "misschien" of waarschijnlijkheidsscore. Dit is een bewuste ontwerpkeuze.

### Waarom is het resultaat binair?

Het resultaat is binair omdat een duidelijk ja-of-nee-antwoord makkelijker te gebruiken is dan een waarschijnlijkheid. De meeste verrijkingstools retourneren een complexe reeks categorieën — catch-all, riskant, onbekend, onverifieerbaar, enz. — die je dwingen om logica rond waarschijnlijkheden op te bouwen. Enrow heeft de tegenovergestelde aanpak gekozen:

* **Enrow verifieert zelfs catch-all-e-mails deterministisch**, dus er is geen behoefte aan een "catch-all"-categorie
* Enrow gelooft niet in probabilistische systemen met tientallen classificaties — ze voegen complexiteit toe zonder duidelijkheid
* Een binair resultaat betekent dat je direct op de gegevens kunt handelen zonder te twijfelen

Het resultaat is ofwel goed, ofwel niet. Eenvoudig.

### Welke kwalificaties retourneert Email Finder?

De [Email Finder](/nl/api-reference/email-finder/find-single) retourneert een van de volgende waarden in het `qualification`-veld:

| Kwalificatie | Betekenis                       |
| ------------ | ------------------------------- |
| `valid`      | E-mail gevonden en geverifieerd |
| `invalid`    | E-mail niet gevonden            |
| `ongoing`    | Zoekopdracht is nog bezig       |

### Welke kwalificaties retourneert Email Verifier?

De [Email Verifier](/nl/api-reference/email-verifier/verify-single) retourneert een van de volgende waarden in het `qualification`-veld:

| Kwalificatie | Betekenis                              |
| ------------ | -------------------------------------- |
| `valid`      | E-mail is geldig en afleverbaar        |
| `invalid`    | E-mail is ongeldig of niet afleverbaar |
| `ongoing`    | Verificatie is nog bezig               |

<Note>
  `invalid` betekent verschillende dingen afhankelijk van het endpoint: bij de **Email Finder** betekent het dat de e-mail niet is gevonden. Bij de **Email Verifier** betekent het dat de e-mail bestaat maar niet afleverbaar is.
</Note>

### Welke kwalificaties retourneert Phone Finder?

De [Phone Finder](/nl/api-reference/phone/find-single) retourneert een van de volgende waarden in het `qualification`-veld:

| Kwalificatie | Betekenis                               |
| ------------ | --------------------------------------- |
| `found`      | Telefoonnummer succesvol gevonden       |
| `not_found`  | Telefoonnummer kon niet worden gevonden |
| `ongoing`    | Zoekopdracht is nog bezig               |

### Hoe volg ik een bulkzoekopdracht?

Voor bulkbewerkingen geeft een `status`-veld de voortgang van de batch aan. Poll het relevante GET-endpoint — [Email Finder bulkresultaten](/nl/api-reference/email-finder/get-bulk-results), [Email Verifier bulkverificaties](/nl/api-reference/email-verifier/get-bulk-verifications), of [Phone Finder bulkresultaten](/nl/api-reference/phone/get-bulk-results) — totdat de `status` op `completed` staat.

| Status      | Betekenis                                     |
| ----------- | --------------------------------------------- |
| `ongoing`   | Batch wordt nog verwerkt                      |
| `completed` | Alle zoekopdrachten in de batch zijn voltooid |
| `failed`    | De batch is mislukt                           |

## FAQ

<AccordionGroup>
  <Accordion title="Waarom krijg ik een 401 in plaats van een 200?">
    Een `401 Unauthorized` betekent dat de API-sleutel ontbreekt of ongeldig is. Zorg ervoor dat elk verzoek een geldige sleutel bevat in de `x-api-key`-header. Zie [Authenticatie](/nl/authentication) voor details.
  </Accordion>

  <Accordion title="Wat betekent een 402-statuscode?">
    Een `402 Payment Required` betekent dat het account niet genoeg credits heeft om het verzoek te voltooien. Vul aan of bekijk hoe credits per endpoint worden verbruikt in [Credits en facturatie](/nl/credits-billing).
  </Accordion>

  <Accordion title="Waarom retourneert een onbekend zoek-ID 400 of 500 in plaats van 404?">
    De Enrow API retourneert nooit `404`. Een onbekend of verlopen zoek-ID retourneert `400` voor bulk-endpoints en `500` voor enkelvoudige endpoints. Controleer de `id` die werd geretourneerd toen de zoekopdracht werd gestart.
  </Accordion>

  <Accordion title="Betekent qualification: ongoing dat er iets is mislukt?">
    Nee. `ongoing` betekent dat de zoekopdracht of verificatie nog bezig is. Poll het GET-endpoint opnieuw na een korte vertraging, of gebruik een webhook om automatisch op de hoogte te worden gesteld wanneer het klaar is — zie [Hoe webhooks werken](/nl/how-webhooks-work).
  </Accordion>
</AccordionGroup>

## Volgende stappen

<CardGroup cols={2}>
  <Card title="Foutafhandeling" icon="triangle-exclamation" href="/nl/error-handling">
    Bekijk de volledige foutmeldingen en responsformaten voor elke statuscode.
  </Card>

  <Card title="Authenticatie" icon="key" href="/nl/authentication">
    Geef je API-sleutel mee in de x-api-key-header om 401-fouten te voorkomen.
  </Card>

  <Card title="Rate limits" icon="gauge-high" href="/nl/rate-limits">
    Begrijp de drempelwaarden die een 429-respons veroorzaken.
  </Card>

  <Card title="Credits en facturatie" icon="coins" href="/nl/credits-billing">
    Bekijk hoe credits worden verbruikt en voorkom 402-fouten.
  </Card>
</CardGroup>
