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

# Enrow API

> Overzicht van de Enrow API om professionele e-mailadressen en telefoonnummers op schaal te vinden en te verifiëren, met asynchrone zoekopdrachten, webhooks en bulkverwerking

Met de Enrow API vind en verifieer je professionele contactgegevens op schaal. Elk verzoek wordt geauthenticeerd met een [API-sleutel](/nl/authentication) in de `x-api-key`-header, en elke zoekopdracht draait asynchroon, zodat je grote volumes kunt verwerken zonder blokkades.

<Note>
  **Base URL** — Alle API-verzoeken gaan naar `https://api.enrow.io`
</Note>

## Wat kan ik doen met de Enrow API?

De Enrow API biedt drie kernfuncties, elk beschikbaar in zowel enkele modus als bulkmodus:

<CardGroup cols={2}>
  <Card title="Email Finder" icon="envelope" href="/nl/api-reference/email-finder/find-single">
    Vind professionele e-mailadressen op basis van een naam en bedrijfsdomein
  </Card>

  <Card title="Email Verifier" icon="shield-check" href="/nl/api-reference/email-verifier/verify-single">
    Verifieer elk e-mailadres met deterministische catch-all-verificatie
  </Card>

  <Card title="Phone Finder" icon="phone" href="/nl/api-reference/phone/find-single">
    Vind directe telefoonnummers op basis van een LinkedIn-URL of naam + bedrijf
  </Card>
</CardGroup>

## Hoe werkt de Enrow API?

Alle endpoints zijn **asynchroon** en volgen hetzelfde patroon: je dient een zoekopdracht in en haalt vervolgens het resultaat op via een webhook of polling.

<Steps>
  <Step title="POST je verzoek">
    Stuur je zoekparameters. Je ontvangt direct een unieke zoek-ID.
  </Step>

  <Step title="Ontvang een melding of poll">
    **Webhook (aanbevolen):** Geef een `webhook`-URL door in `settings` en laat het resultaat direct naar je server POSTen. Zie [Hoe webhooks werken](/nl/how-webhooks-work).

    **Polling:** Roep het GET-endpoint aan met de zoek-ID.
  </Step>

  <Step title="Gebruik het resultaat">
    Het `qualification`-veld geeft aan of het resultaat `valid`, `invalid`, `found` of `not_found` is.
  </Step>
</Steps>

## Hoe maak ik mijn eerste verzoek?

Authenticeer met je API-sleutel in de `x-api-key`-header en POST een zoekopdracht naar het relevante endpoint. Het onderstaande voorbeeld voert één enkele e-mailzoekopdracht uit:

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl -X POST https://api.enrow.io/email/find/single \
      -H "x-api-key: YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "fullname": "Dwight Schrute",
        "company_domain": "dundermifflin.com"
      }'
    ```
  </Tab>

  <Tab title="Node.js">
    ```javascript 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'
      })
    });

    const data = await response.json();
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    import requests, os

    response = requests.post(
        "https://api.enrow.io/email/find/single",
        headers={"x-api-key": os.getenv("ENROW_API_KEY")},
        json={
            "fullname": "Dwight Schrute",
            "company_domain": "dundermifflin.com"
        }
    )
    print(response.json())
    ```
  </Tab>
</Tabs>

**Response:**

```json theme={null}
{
  "message": "Single search operating",
  "id": "910f3e13-b2bf-442d-ab0b-4cf44d...",
  "credits_used": 1
}
```

De POST is asynchroon — de `email` en `qualification` worden later opgehaald via het [GET-endpoint](/nl/api-reference/email-finder/get-single-result) of een [webhook](/nl/how-webhooks-work).

## Moet ik de enkele modus of bulkmodus gebruiken?

Gebruik de enkele modus voor realtime, eenmalige opzoekingen en de bulkmodus voor verrijking op grote schaal. Elk endpoint ondersteunt beide:

|                   | Enkel                         | Bulk                            |
| ----------------- | ----------------------------- | ------------------------------- |
| **Batchgrootte**  | 1                             | Tot 5.000 (3.000 voor telefoon) |
| **Geschikt voor** | Realtime opzoekingen          | Verrijking op grote schaal      |
| **Webhook**       | Volledig resultaat in payload | Melding, daarna GET             |

Voor bulkopdrachten, zie [E-mails zoeken](/nl/api-reference/email-finder/find-bulk), [E-mails verifiëren](/nl/api-reference/email-verifier/verify-bulk) en [Telefoons zoeken](/nl/api-reference/phone/find-bulk).

## Wat maakt de Enrow API anders?

De Enrow API combineert deterministische verificatie met flexibele resultaatlevering, zodat je nauwkeurige data krijgt zonder extra tooling:

<CardGroup cols={2}>
  <Card title="Catch-all-verificatie" icon="check-double">
    Deterministische verificatie die zelfs werkt op catch-all-domeinen. Geen debouncer nodig.
  </Card>

  <Card title="Aangepaste velden" icon="tag">
    Geef je eigen `custom`-data mee bij elke zoekopdracht — deze wordt ongewijzigd teruggegeven in het resultaat.
  </Card>
</CardGroup>

<Card title="Webhooks" icon="bolt" href="/nl/how-webhooks-work">
  Ontvang resultaten in realtime. Geen polling, geen verspilde API-aanroepen.
</Card>

## FAQ

<AccordionGroup>
  <Accordion title="Hoe authenticeer ik API-verzoeken?">
    Elk verzoek moet je API-sleutel bevatten in de `x-api-key`-header — er zijn geen OAuth-flows of bearer-tokens. Zie [Authenticatie](/nl/authentication) voor de setup en voorbeelden.
  </Accordion>

  <Accordion title="Waarom zijn responses asynchroon?">
    Een POST-verzoek start een zoekopdracht en geeft direct een unieke `id` terug. De `email`, `phone` of `qualification` wordt later geleverd via een [webhook](/nl/how-webhooks-work) of door het bijbehorende GET-endpoint te pollen met die `id`.
  </Accordion>

  <Accordion title="Hoeveel zoekopdrachten kan ik in één bulkverzoek uitvoeren?">
    Bulkverzoeken voor e-mail en e-mailverificatie accepteren tot 5.000 zoekopdrachten, en bulkverzoeken voor telefoon accepteren tot 3.000. Voor enkele verzoeken is de batchgrootte 1.
  </Accordion>

  <Accordion title="Hoe worden credits verbruikt?">
    Credits worden per zoekopdracht afgeschreven en het bedrag wordt teruggegeven in `credits_used`. Zie [Credits en facturatie](/nl/credits-billing) voor de kosten per endpoint en [Rate limits](/nl/rate-limits) voordat je opschaalt.
  </Accordion>
</AccordionGroup>

## Volgende stappen

<CardGroup cols={2}>
  <Card title="Authenticatie" icon="key" href="/nl/authentication">
    Stel je API-sleutel in via de x-api-key-header
  </Card>

  <Card title="Hoe webhooks werken" icon="bolt" href="/nl/how-webhooks-work">
    Ontvang resultaten in realtime, geen polling nodig
  </Card>

  <Card title="Credits en facturatie" icon="coins" href="/nl/credits-billing">
    Begrijp hoe credits per endpoint worden verbruikt
  </Card>

  <Card title="Foutafhandeling" icon="circle-info" href="/nl/error-handling">
    Statuscodes, kwalificaties en foutformaten
  </Card>
</CardGroup>